תצורת סקריפט מועדפים

דף זה מתאר את פרמטרי התצורה של סקריפט favorite המשמש ליצירת משימות.

סקירה כללית

סקריפט favorite מוסיף פוסט למועדפים (ב-TikTok) / שמורים (ב-Instagram). כאשר אתה מספק מספר כתובות URL דרך ה-API, נוצרת משימה אחת לכל URL. ניתן לשלוט בזמן ביצוע כל משימה באמצעות start_time.

פוסטים שכבר נשמרו במועדפים מדולגים

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

הגדרות הסקריפט (script_config)

האובייקט script_config מכיל את פרמטרי התצורה של סקריפט המועדפים:

פרמטרים

פרמטר	סוג	נדרש	ברירת מחדל	תיאור
target_post_urls	string[]	Yes*	[]	מערך כתובות URL להוספה למועדפים (משימה אחת לכל URL)
target_post_url	string	Yes*	""	כתובת URL יחידה, או מספר URL מופרדות בירידות שורה/פסיקים

note

חייב לספק מערך target_post_urls או מחרוזת target_post_url. אם שניהם מסופקים, target_post_urls קודם.

יצירת משימות

כאשר מסופקות מספר כתובות URL, ה-API יוצר משימה אחת לכל URL. עם 3 URL ו-2 מכשירים, ייווצרו 6 משימות. השתמש ב-start_time לשליטה בזמן ביצוע.

דוגמאות

הוספת פוסט אחד למועדפים

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

הוספת מספר פוסטים למועדפים

בהוספת מספר פוסטים למועדפים, נוצרת משימה לכל פוסט:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222",
        "https://www.tiktok.com/@user3/video/333"
      ]
    }
  }'

פעולה זו יוצרת 3 משימות נפרדות שמבוצעות מיד.

תזמון הוספה למועדפים עם זמן התחלה

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    },
    "start_time": "14:30"
  }'

הוספה למועדפים לפי רשימת שמות משתמש

צור משימות מועדפים ישירות לחשבונות ספציפיים:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123"
    }
  }'

דוגמת Instagram

ב-Instagram, סקריפט favorite שומר את הפוסט (סימניה):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/"
    }
  }'

תגובה

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [601, 602, 603],
    "created_count": 3
  }
}

פורמטים של כתובות URL

TikTok

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

שיטות עבודה מומלצות

1. תזמן משימות: השתמש בפרמטר start_time לפיזור הפעולות על פני זמן.

2. מצב מרובה חשבונות: הפעל enable_multi_account להוספה למועדפים עם מספר חשבונות.

קודי שגיאה

Code	Description
40001	כתובת URL של פוסט מטרה חסרה
40003	הסקריפט אינו נתמך דרך ה-API
40301	גישה ל-API דורשת תוכנית Pro+

ראה גם

• תצורת סקריפט לייק - לייק לפוסטים
• תצורת סקריפט צפייה - צפייה בפוסטים למשך זמן מסוים
• API ניהול משימות - יצירה, רשימה וניהול משימות
• סקירת API מקומי - סקירה כללית של ה-API