API ניהול משימות

עדכון רשימת סקריפטים\nTask API כולל כעת follow_back ו-scrape_users; repost פועל ב-TikTok/Threads ו-message ב-Threads בלבד. לפרטים ראו בדפי ההגדרות המתורגמים.\n:::

עמוד זה מתעד את כל נקודות הקצה הזמינות לניהול משימות TikMatrix.

יצירת משימה

צור משימות חדשות עבור מכשירים או שמות משתמש.

• נקודת קצה: POST /api/v1/task
• Content-Type: application/json

פרמטרי בקשה

פרמטר	סוג	נדרש	תיאור
serials	string[]	תנאי	מערך מספרי סידורי של מכשירים
usernames	string[]	תנאי	מערך שמות משתמש
script_name	string	כן	שם הסקריפט לביצוע
script_config	object	כן	פרמטרי תצורת סקריפט
enable_multi_account	boolean	לא	האם להפעיל מצב ריבוי חשבונות
start_time	string	לא	זמן ביצוע מתוכנן (פורמט: "HH:MM")
close_app	boolean	לא	האם לסגור (לעצור בכפייה) את אפליקציית היעד בסיום המשימה (ברירת מחדל: true). הגדר false כדי להשאיר את האפליקציה פועלת לאחר השלמת המשימה.
platform	string	לא	פלטפורמת היעד (tiktok, instagram או threads). בשימוש רק ב‑TikMatrix Pro; מתעלמים ממנה בגרסאות לפלטפורמה יחידה.

סקריפטים נתמכים

שם סקריפט	תיאור	תיעוד
post	פרסום תוכן על TikTok/Instagram	תצורת סקריפט פרסום
follow	עקוב או הפסק לעקוב אחרי משתמשים	תצורת סקריפט מעקב
unfollow	הפסק לעקוב אחרי משתמשים	תצורת סקריפט ביטול מעקב
account_warmup	חמם חשבונות	תצורת סקריפט חימום חשבון
comment	תגובות על פרסומים	תצורת סקריפט תגובות
login	התחבר לחשבון	תצורת סקריפט התחברות
profile	עדכן פרופיל	תצורת סקריפט פרופיל
match_account	התאם חשבונות במכשיר	תצורת סקריפט התאמת חשבונות
like	אהבה על פרסומים	תצורת סקריפט אהבה
view	צפיה בפרסום לפרק זמן	תצורת סקריפט צפיה
favorite	שמור פרסום למועדפים	תצורת סקריפט מועדפים
repost	שיתוף חוזר של סרטוני TikTok	תצורת סקריפט שיתוף חוזר
message	שלח הודעה ישירה	תצורת סקריפט הודעה
follow_suggested	עקוב אחרי חשבונות מוצעים	תצורת סקריפט מעקב מוצע

השארת האפליקציה פתוחה לאחר המשימה

כברירת מחדל, אפליקציית היעד נעצרת בכפייה בסיום המשימה, כדי לשקף את התנהגות התוכנה ולשחרר משאבי מכשיר. העבר "close_app": false כדי להשאיר את האפליקציה פועלת לאחר השלמת המשימה — שימושי לשרשור משימות או לבדיקת התוצאה במכשיר:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "like",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@user/video/123"
    },
    "close_app": false
  }'

רשימת משימות

שאל משימות עם מסננים אופציונליים.

• נקודת קצה: GET /api/v1/task

פרמטר	סוג	תיאור
status	integer	סינון לפי מצב
serial	string	סינון לפי מספר סידורי מכשיר
page	integer	מספר עמוד
page_size	integer	פריטים לעמוד

קבלת פרטי משימה

• נקודת קצה: GET /api/v1/task/{task_id}

מחיקת משימה

• נקודת קצה: DELETE /api/v1/task/{task_id}

עצירת משימה

• נקודת קצה: POST /api/v1/task/{task_id}/stop

ניסיון חוזר למשימה

• נקודת קצה: POST /api/v1/task/{task_id}/retry

סטטיסטיקות משימות

• נקודת קצה: GET /api/v1/task/stats

ראה גם

• תצורת סקריפט פרסום
• תצורת סקריפט מעקב
• תצורת סקריפט ביטול מעקב
• תצורת סקריפט חימום חשבון
• תצורת סקריפט תגובות
• תצורת סקריפט התחברות
• תצורת סקריפט פרופיל
• תצורת סקריפט התאמת חשבונות