תצורת סקריפט פרסום

עמוד זה מתעד את פרמטרי התצורה עבור סקריפט post המשמש ליצירת משימות.

סקירה כללית

סקריפט post משמש לפרסום תוכן אוטומטי (סרטונים או תמונות) ל-TikTok או Instagram. הוא תומך במספר שיטות פרסום, מקורות חומר ואפשרויות אודיו.

פרמטרי בקשה

בעת יצירת משימה, ניתן לציין את הפרמטרים הבאים ברמה העליונה:

פרמטר	סוג	נדרש	ברירת מחדל	תיאור
serials	string[]	מותנה	[]	רשימת מספרי סידור של מכשירים (מצב 1: מבוסס מכשיר)
usernames	string[]	מותנה	[]	רשימת שמות משתמש ליצירת משימות עבורם (מצב 2: מבוסס שם משתמש)
script_name	string	כן	-	שם הסקריפט להפעלה (למשל, "post")
script_config	object	כן	-	פרמטרי תצורת הסקריפט (ראה להלן)
enable_multi_account	boolean	לא	false	הפעל מצב חשבונות מרובים (צור משימה לכל חשבון במכשיר)
start_time	string	לא	-	זמן התחלה אופציונלי בפורמט "HH:MM"
platform	string	מותנה*	auto	פלטפורמת היעד: tiktok, instagram. ראה הערה למטה

הערה: יש לספק serials או usernames.

*התנהגות פרמטר Platform:

• TikMatrix ו-IgMatrix: פרמטר platform מתעלם אם מסופק. הפלטפורמה נקבעת אוטומטית משם האפליקציה (TikMatrix → tiktok, IgMatrix → instagram).
• TikMatrix Pro: פרמטר platform נדרש ויש לציין אותו במפורש כ-tiktok או instagram.

פרמטרים כלליים

פרמטר	סוג	נדרש	תיאור
content_type	integer	לא	0=וידאו, 1=תמונה
captions	string	לא	כיתוב הפוסט
material_list	string[]	לא	רשימת נתיבי קבצים
post_way	string	לא	שיטת פרסום
upload_wait_time	integer	לא	זמן המתנה להעלאה (שניות)

פרמטרים ספציפיים ל-TikTok

פרמטר	סוג	תיאור
add_product_link	integer	הוספת קישור למוצר

פרמטרים ספציפיים ל-Instagram

פרמטר	סוג	תיאור
placement	string	reel או story

דוגמאות

פרסום בסיסי

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "סרטון חדש!",
      "material_list": ["C:/Videos/video1.mp4"]
    }
  }'

פרסום עם בחירת פלטפורמה מפורשת

ניתן לציין במפורש את פלטפורמת היעד באמצעות הפרמטר platform. זה שימושי כאשר ברצונך לעקוף את ברירת המחדל של הסביבה:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "מפרסם ב-Instagram! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

ראה גם

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