דלג לתוכן הראשי

סקירת API מקומי

TikMatrix מספק API מקומי בסגנון RESTful המאפשר לך לנהל משימות באופן תכנותי. זה שימושי לשילוב TikMatrix עם מערכות האוטומציה שלך, לבניית זרימות עבודה מותאמות אישית, או ליצירת פעולות אצוות.

דרישות​

דרישות רישיון

ה-API המקומי זמין רק למשתמשי תוכניות Pro, Team ו-Business. תוכנית Starter אינה כוללת גישה ל-API.

כתובת URL בסיסית​

ה-API פועל מקומית בכתובת:

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

הפורט 50809 הוא פורט ברירת המחדל. ודא ש-TikMatrix פועל לפני שליחת בקשות.

פורמט תגובה​

כל תגובות ה-API עוקבות אחר הפורמט הבא:

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

קודי תגובה​

קודתיאור
0הצלחה
40001שגיאת פרמטר - פרמטרים לא תקינים
40002שגיאת פרמטר - script_name חסר
40003שגיאת פרמטר - הסקריפט אינו נתמך או מצב משימה לא תקף
40004שגיאת פרמטר - רק משימות בהפעלה יכולות להיעצר
40005שגיאת פרמטר - task_ids לא יכול להיות ריק
40301אסור - דרושה תוכנית Pro+
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,
    "start_time": "14:30"
  }'

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גרידת נתוני משתמש🔜 בקרוב
† שיווק מתקדם משתמש ב-endpoints ייעודיים

קמפיין השיווק המתקדם אינו נוצר דרך POST /api/v1/task. הוא עובד על בסיס מאגר יעדים לשימוש חוזר ויש לו endpoints ייעודיים — ראה הגדרת סקריפט שיווק מתקדם.

סטטוס משימה​

קוד סטטוסטקסט סטטוסתיאור
0pendingהמשימה ממתינה לביצוע
1runningהמשימה מתבצעת כעת
2completedהמשימה הושלמה בהצלחה
3failedהמשימה נכשלה

ראה גם​