تكوين نص النشر

تسجل هذه الصفحة معاملات تكوين نص 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.

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

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

المعاملات العامة (TikTok و Instagram)

المعامل	النوع	مطلوب	القيمة الافتراضية	الوصف
content_type	integer	لا	0	نوع المحتوى: 0 = فيديو، 1 = صورة
image_count	integer	لا	1	عدد الصور المراد تحديدها (عندما content_type = 1)
captions	string	لا	""	نص عنوان المنشور. يدعم تنسيق spintax: {خيار1|خيار2|خيار3}
post_way	string	لا	"share"	طريقة النشر: share أو addButton أو useSound
material_source	string	لا	"materialLibrary"	مصدر المواد: materialLibrary (مكتبة المواد) أو localFolder (مجلد محلي)، يتم تجاهل هذا المعامل إذا تم توفير material_list
material_path	string	مطلوب شرطيًا	""	مسار المجلد المحلي (مطلوب عندما material_source = "localFolder")
material_list	string[]	لا	[]	تمرير مصفوفة مسارات ملفات المواد مباشرة. عند توفير هذا المعامل، سيتم تخطي منطق material_source و material_path. موصى به لسيناريوهات أتمتة API.
materials_tags	string	لا	""	علامات المواد مفصولة بفواصل، تُستخدم لتصفية من مكتبة المواد
upload_wait_time	integer	لا	30	الثواني للانتظار حتى اكتمال التحميل
sound_wait_time	integer	لا	10	الثواني للانتظار حتى تحميل الصوت
add_sound	string/integer	لا	"-1"	خيارات الصوت: -1 = افتراضي، 0 = تعطيل، 1 = تمكين، custom = استخدام صوت مخصص
sound_name	string	مطلوب شرطيًا	""	اسم/URL الصوت (مطلوب عندما post_way = "useSound")
custom_sound_keyword	string	مطلوب شرطيًا	""	كلمة مفتاحية للبحث عن صوت مخصص (مطلوب عندما add_sound = "custom")
origin_sound_volume	integer	لا	50	مستوى صوت الصوت الأصلي (0-100)
add_sound_volume	integer	لا	50	مستوى صوت الصوت المضاف (0-100)

معاملات خاصة بـ TikTok

المعامل	النوع	مطلوب	القيمة الافتراضية	الوصف
add_product_link	integer	لا	0	إضافة رابط منتج: 0 = لا، 1 = نعم

معاملات خاصة بـ Instagram

المعامل	النوع	مطلوب	القيمة الافتراضية	الوصف
placement	string	لا	"reel"	موضع النشر: reel (ريل) أو story (قصة)

أمثلة

مهمة نشر أساسية - تمرير مسارات المواد مباشرة

هذه هي الطريقة الموصى بها لأتمتة API - تمرير مسارات ملفات المواد مباشرة، دون الاعتماد على مكتبة المواد أو مسح المجلدات:

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": "شاهد الفيديو الجديد الخاص بي! #trending #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

النشر باستخدام مكتبة المواد (TikTok)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "شاهد الفيديو الجديد الخاص بي! #trending #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

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

يتيح لك هذا الوضع إنشاء مهام مباشرة لحسابات محددة، دون الحاجة إلى معرفة أرقامها التسلسلية:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@user1", "@user2", "@user3"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "شاهد الفيديو الجديد الخاص بي! #trending #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

النشر من مجلد محلي (Instagram)

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": "محتوى رائع! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

النشر باستخدام صوت مخصص

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": "الرقص مع هذه الموسيقى الشعبية!",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "موسيقى رقص شعبية 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

النشر باستخدام URL صوت محدد

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "post_way": "useSound",
      "sound_name": "https://www.tiktok.com/music/original-sound-7123456789",
      "captions": "استخدام هذه الموسيقى الرائعة!",
      "material_source": "materialLibrary"
    }
  }'

نشر الصور (ألبوم دوار)

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": 1,
      "image_count": 5,
      "captions": "شاهد هذه الصور! #photoset",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

النشر مع تحديد المنصة بشكل صريح

يمكنك تحديد المنصة المستهدفة بشكل صريح باستخدام معامل 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
    }
  }'

الاستجابة

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [101, 102],
    "created_count": 2
  }
}

الوثائق ذات الصلة

• API إدارة المهام - إنشاء وإدراج وإدارة المهام