Skip to main content

ภาพรวม Local API

TikMatrix มี Local RESTful API ที่ช่วยให้คุณจัดการงานผ่านโปรแกรมได้ เหมาะสำหรับการเชื่อม TikMatrix เข้ากับระบบอัตโนมัติของคุณเอง การทำเวิร์กโฟลว์เฉพาะทาง หรือการทำงานแบบแบตช์

ข้อกำหนด​

ข้อกำหนดด้านไลเซนส์

Local API เปิดให้ใช้งานเฉพาะผู้ใช้แผน Pro, Team และ Business เท่านั้น แผน Starter จะไม่สามารถเข้าถึง API ได้

Base URL​

API ทำงานบนเครื่องโลคัลที่:

http://localhost:50809/api/v1/
note

พอร์ต 50809 คือพอร์ตเริ่มต้น โปรดตรวจสอบว่า TikMatrix กำลังทำงานก่อนเรียก API

รูปแบบการตอบกลับ​

การตอบกลับของ API ทั้งหมดใช้รูปแบบเดียวกัน:

{
  "code": 0,
  "message": "success",
  "data": { ... }
}

คำอธิบายรหัสตอบกลับ​

Codeคำอธิบาย
0สำเร็จ
40001พารามิเตอร์ไม่ถูกต้อง
40002พารามิเตอร์ไม่ครบ - ขาด script_name
40003พารามิเตอร์ไม่ถูกต้อง - สคริปต์ไม่ได้รับการสนับสนุนหรือสถานะงานไม่ถูกต้อง
40004พารามิเตอร์ไม่ถูกต้อง - สามารถหยุดเฉพาะงานที่กำลังทำงาน
40005พารามิเตอร์ไม่ถูกต้อง - task_ids ไม่สามารถเว้นว่างได้
40301ถูกปฏิเสธ - ต้องใช้แผน Pro+ เพื่อเข้าถึง API
40401ไม่พบทรัพยากร
50001ข้อผิดพลาดภายในเซิร์ฟเวอร์

เริ่มต้นใช้งานอย่างรวดเร็ว​

1) ตรวจสอบสิทธิ์การเข้าถึง API​

ตรวจสอบว่าไลเซนส์ของคุณรองรับ API หรือไม่:

curl http://localhost:50809/api/v1/license/check

ตัวอย่างการตอบกลับ:

{
  "code": 0,
  "message": "success",
  "data": {
    "plan_name": "Pro",
    "api_enabled": true,
    "device_limit": 20,
    "message": "API access enabled"
  }
}

2) สร้างงาน​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "captions": "วิดีโอใหม่ของฉัน! #กำลังฮิต"
    },
    "enable_multi_account": false
  }'

3) แสดงรายการงาน​

curl "http://localhost:50809/api/v1/task?status=0&page=1&page_size=20"

สคริปต์ที่รองรับ​

พารามิเตอร์ script_name รองรับค่าต่อไปนี้:

ชื่อสคริปต์คำอธิบายรองรับ API
postโพสต์เนื้อหา✅ รองรับ
followติดตามผู้ใช้✅ รองรับ
unfollowเลิกติดตามผู้ใช้✅ รองรับ
account_warmupวอร์มบัญชี✅ รองรับ
commentแสดงความคิดเห็น✅ รองรับ
boost_commentถูกใจ/ตอบกลับความคิดเห็นที่มีอยู่✅ รองรับ
loginเข้าสู่ระบบบัญชี✅ รองรับ
profileอัปเดตโปรไฟล์✅ รองรับ
match_accountจับคู่บัญชีในอุปกรณ์✅ รองรับ
likeกดไลก์✅ รองรับ
viewดูโพสต์เป็นระยะเวลาที่กำหนด✅ รองรับ
favoriteบันทึกโพสต์ไปยังรายการโปรด✅ รองรับ
repostรีโพสต์วิดีโอ TikTok✅ รองรับ
messageส่งข้อความ✅ รองรับ
follow_suggestedติดตามบัญชีที่แนะนำ✅ รองรับ
super_marketingแคมเปญซุปเปอร์มาร์เก็ตติ้ง✅ รองรับ †
scrape_userดึงข้อมูลผู้ใช้🔜 เร็วๆ นี้
† Super Marketing ใช้ endpoint เฉพาะ

แคมเปญ Super Marketing ไม่ได้ สร้างผ่าน POST /api/v1/task แต่ทำงานบนชุดข้อมูลเป้าหมายที่นำกลับมาใช้ใหม่ได้ และมี endpoint เฉพาะของตัวเอง — ดู การตั้งค่าสคริปต์ Super Marketing

สถานะงาน​

รหัสสถานะข้อความสถานะคำอธิบาย
0pendingงานรอการดำเนินการ
1runningงานกำลังทำงาน
2completedงานสำเร็จ
3failedงานล้มเหลว

อ่านต่อ​