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

تكوين نص المفضلة

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

نظرة عامة​

يضيف نص favorite منشوراً إلى المفضلة (على TikTok) / المحفوظات (على Instagram). عند توفير عدة روابط منشورات مستهدفة عبر API، سينشئ النظام مهمة لكل رابط منشور. يمكنك التحكم في وقت تنفيذ كل مهمة باستخدام معامل start_time.

يتم تخطي المنشورات المحفوظة بالفعل

يكتشف النص المنشورات المضافة إلى المفضلة / المحفوظات مسبقاً ويتخطاها، لذا إعادة تشغيل مهمة لن تُلغي تفضيل المنشور.

تكوين النص البرمجي (script_config)​

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

المعاملات​

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

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

إنشاء المهام

عند توفير عدة روابط منشورات مستهدفة، سينشئ API مهمة لكل رابط منشور. على سبيل المثال، إذا حددت 3 روابط منشورات وجهازين، سيتم إنشاء 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
  }
}

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

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 لإضافة المنشورات إلى المفضلة باستخدام حسابات متعددة على نفس الجهاز.

رموز الخطأ​

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

انظر أيضاً​