تكوين نص المشاهدة

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

نظرة عامة

يفتح نص view منشوراً على TikTok أو Instagram ويشاهده لمدة قابلة للتكوين — مفيد لزيادة وقت المشاهدة / الانطباعات. عند توفير عدة روابط منشورات مستهدفة عبر API، سينشئ النظام مهمة لكل رابط منشور. يمكنك استخدام معامل start_time للتحكم في وقت تنفيذ المهام.

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

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

المعاملات

المعامل	النوع	مطلوب	القيمة الافتراضية	الوصف
target_post_urls	string[]	Yes*	[]	مصفوفة روابط المنشورات المستهدفة للمشاهدة (مهمة لكل رابط)
target_post_url	string	Yes*	""	رابط منشور مستهدف واحد، أو عدة روابط مفصولة بفواصل أسطر/فواصل
view_duration	integer	No	10	ثوانٍ لمشاهدة المنشور
view_durations	integer[]	No	—	نطاق [min, max] بالثواني؛ يُستخدم قيمة عشوائية ضمن النطاق. يأخذ الأولوية على view_duration

ملاحظة

يجب توفير مصفوفة 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": "view",
    "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": "view",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "view_duration": 30
    }
  }'

المشاهدة لمدة عشوائية

يُستخدم وقت مشاهدة عشوائي بين 15 و45 ثانية لكل مهمة:

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

المشاهدة باستخدام قائمة أسماء المستخدمين

إنشاء مهام مشاهدة مباشرة لحسابات محددة:

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

مثال Instagram

تعمل نفس الـ API مع منشورات ومقاطع Instagram:

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

الاستجابة

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502],
    "created_count": 2
  }
}

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

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/

Threads

https://www.threads.com/@username/post/ABCDEFGHIJK
https://www.threads.com/t/ABCDEFGHIJK

تعمل روابط threads.net أيضًا. رابط /share/ لا يعمل: الرمز الخاص به مختلف عن ذلك الذي تستخدمه صفحة المنشور، لذا يتم رفضه بدلًا من تحويله إلى رابط يشير إلى لا شيء.

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

1. تنويع وقت المشاهدة: يُفضل استخدام view_durations بدلاً من view_duration الثابت حتى تبدو كل مشاهدة أكثر طبيعية.

2. جدولة المهام: استخدم معامل start_time لتوزيع المشاهدات على مدار الوقت.

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

رموز الخطأ

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

انظر أيضاً

• تكوين نص الإعجاب - الإعجاب بالمنشورات
• تكوين نص المفضلة - حفظ المنشورات في المفضلة
• API إدارة المهام - إنشاء وعرض وإدارة المهام
• نظرة عامة على API المحلي - نظرة عامة على API والبدء السريع