إنتقل إلى المحتوى الرئيسي

تكوين نص الريبوست

توثق هذه الصفحة معلمات التكوين لنص repost المستخدم في إنشاء المهام.

نظرة عامة​

يُستخدم نص repost لإعادة نشر مقاطع فيديو TikTok تلقائيًا. عند توفير عناوين URL متعددة لمنشورات مستهدفة عبر API، يتم إنشاء مهمة واحدة لكل عنوان URL. يمكنك التحكم في وقت تنفيذ كل مهمة باستخدام معلمة start_time.

TikTok فقط

يدعم نص repost TikTok فقط. لا تمتلك Instagram وظيفة إعادة نشر أصلية.

تكوين النص (script_config)​

يحتوي كائن script_config على معلمات نص الريبوست. فيما يلي المعلمات المتاحة:

المعلمات​

المعلمةالنوعمطلوبالافتراضيالوصف
target_post_urlsstring[]Yes*[]مصفوفة عناوين URL للمنشورات المستهدفة لإعادة النشر (مهمة واحدة لكل URL)
target_post_urlstringYes*""عنوان URL واحد للمنشور المستهدف أو عناوين URL متعددة مفصولة بأسطر جديدة/فواصل
ملاحظة

يجب توفير مصفوفة target_post_urls أو سلسلة target_post_url. إذا تم توفير كلاهما، يكون لـ target_post_urls الأولوية.

إنشاء المهام

عند توفير عناوين URL متعددة للمنشورات، تُنشئ API مهمة واحدة لكل URL. على سبيل المثال، إذا حددت 3 عناوين URL وجهازين، سيتم إنشاء 6 مهام. استخدم معلمة start_time للتحكم في وقت بدء تنفيذ المهام.

أمثلة​

إعادة نشر منشور واحد​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "repost",
    "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": "repost",
    "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 مهام مستقلة تُنفَّذ على الفور.

جدولة إعادة النشر بوقت بدء​

استخدم start_time لجدولة وقت بدء المهام:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "repost",
    "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": "repost",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123"
    }
  }'

إعادة النشر الجماعية على أجهزة متعددة​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "repost",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@viral/video/999"
    },
    "enable_multi_account": true
  }'

الاستجابة​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [401, 402, 403],
    "created_count": 3
  }
}

تنسيقات URL المنشور​

TikTok​

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

كيفية عمل إعادة النشر​

  1. يفتح النص عنوان URL للمنشور المستهدف.
  2. يتحقق مما إذا كان المنشور قد أُعيد نشره بالفعل — إذا كان الأمر كذلك، يتخطاه لتجنب إعادة النشر المكررة.
  3. ينقر على زر مشاركة، ثم يختار إعادة النشر من القائمة.
  4. يؤكد عملية إعادة النشر.

أفضل الممارسات​

  1. جدولة المهام: استخدم معلمة start_time لتوزيع عمليات إعادة النشر عبر الزمن، مما يقلل من خطر تقييد المعدل.

  2. تجميع ذكي: لا تنشئ عددًا كبيرًا جدًا من مهام إعادة النشر دفعة واحدة. قد تفرض المنصات قيودًا على معدل إعادة النشر.

  3. استخدام وضع متعدد الحسابات: قم بتمكين enable_multi_account لإعادة نشر مقاطع الفيديو باستخدام حسابات متعددة على نفس الجهاز.

رموز الخطأ​

CodeDescription
40001عنوان URL للمنشور المستهدف مفقود
40003النص غير مدعوم عبر API
40301يتطلب الوصول إلى API خطة Pro+

انظر أيضًا​