إرسال فيديو إلى مسودات المنشئ على TikTok عبر الواجهة البرمجية
تُرسل واجهات TikTok البرمجية الفيديو إلى مسودات المنشئ عبر تدفق الرفع: تستخدم Content Posting API المسار /v2/post/publish/inbox/video/init/ لرفعه بنطاق video.upload، فترسل TikTok إلى صندوق وارد المنشئ إشعارًا ليحرره وينشره داخل التطبيق. وتفعل API for Business الشيء نفسه باستخدام upload_to_draft على /business/video/publish/، أو باستخدام is_draft في منشورات الصور.
ينشر easyCoexistence فيديوهات TikTok ومنشورات الصور عبر publish_tiktok_post من Claude أو ChatGPT أو منصتك الخاصة، الآن أو في موعد يصل إلى 90 يومًا مقدمًا، ويبقى كل منشور في قائمة الانتظار ظاهرًا في شاشة المنشورات حتى يخرج.
نطاق تعرّفه TikTok بأنه مشاركة المحتوى إلى حساب المنشئ كمسودة لمزيد من التحرير والنشر داخل التطبيق.
أكبر عدد من المشاركات المعلقة تسمح به Content Posting API خلال أي فترة مدتها 24 ساعة، وهو حد تضعه TikTok للحد من المحتوى المزعج.
تُبلّغ الحالة /business/publish/status/ بمجرد رفع المسودة وإشعار TikTok لصندوق وارد المنشئ.
في Content Posting API، عدد الطلبات التي يستطيع كل رمز الوصول (token) للمستخدم إرسالها إلى نقطة النهاية (endpoint) الخاصة بالرفع.
ما يحدث لبقية حقول post_info حين تكون upload_to_draft بقيمة true على مسار /business/video/publish/ الخاص بالفيديو.
كيف تختلف المسودة عن المنشور المباشر؟
يكمن الفرق في من يضغط زر النشر. المنشور المباشر يصبح منشورًا فعليًا بعد أن تعالجه TikTok، أما المسودة فتصل إلى صندوق وارد المنشئ في TikTok، ولا تُنشر إلا حين يفتحها المنشئ ويعدّلها كما يشاء وينشرها. ويظهر الفرق في واجهتي النشر لدى TikTok:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
كيف تعمل Content Posting API على رفع المسودة؟
عبر طلب POST إلى https://open.tiktokapis.com/v2/post/publish/inbox/video/init/، مع رمز الوصول للمستخدم الذي يحمل نطاق video.upload، وكائن source_info. تجعل PULL_FROM_URL من TikTok تجلب الفيديو من نطاق أو بادئة عنوان URL تحقق منها التطبيق، بينما تعيد FILE_UPLOAD عنوان upload_url، ويُرسل الملف إليه على أجزاء بطلبات PUT. يُرسَل publish_id المُعاد إلى /v2/post/publish/status/fetch/، وتستخدم الصور /v2/post/publish/content/init/ مع ضبط post_mode على MEDIA_UPLOAD، وتطلب TikTok من التطبيقات أن تُخبر المستخدمين بفتح إشعار الصندوق الوارد لمواصلة التحرير داخل التطبيق:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/في Content Posting API، أي الحدود تنطبق على المسودات؟
توثّق TikTok هذه الحدود في مرجع الرفع الخاص بها، ويُعاد كل منها من طلب init عندما ينطبق:
- المسودات المعلقة: لا تتجاوز 5 مشاركات معلقة في أي فترة 24 ساعة، وعند التجاوز يُعاد
spam_risk_too_many_pending_shareمع رمز HTTP 403 الخاص بالحد. - الطلبات: 6 طلبات في الدقيقة لكل رمز وصول للمستخدم، وعند التجاوز يُعاد
rate_limit_exceededبرمز HTTP 429 لتقييد المعدل. - النطاق: الرمز الذي لا يملك video.upload يتلقى
scope_not_authorizedبرمز HTTP 401 الخاص بعدم التفويض. - الوسائط: طلب
PULL_FROM_URLمن نطاق أو بادئة لم يتحقق منها التطبيق يُعاد لهurl_ownership_unverifiedبرمز HTTP 403 لملكية غير مؤكدة.
في API for Business، كيف تُرفع المسودة؟
عبر نقاط النشر الخاصة به وحقل إضافي واحد في post_info. على /business/video/publish/ يؤدي ضبط upload_to_draft على true إلى إرسال الفيديو كمسودة، وتتجاهل TikTok بقية حقول post_info؛ وعلى /business/photo/publish/ يُبقي is_draft العنوان والتعليق فقط. يلزم في الحالتين نطاق video.upload على رمز الحساب، الذي يسرده /tt_user/token_info/get/، وفي غيابه يوافق المالك على رفع المسودات بإعادة تفويض التطبيق. تبقى الوسائط على عنوان URL متحقق منه، وتعرض الحالة SEND_TO_USER_INBOX، ويجد المنشئ المسودة عبر إشعار الصندوق الوارد:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'ماذا يفعل المنشئ بالمسودة؟
ينهيها داخل TikTok. يفتح إشعار الصندوق الوارد الفيديو أو الصور المرفوعة في محرر TikTok، حيث يراجعها المنشئ ويعدّلها وينشرها. في Content Posting API تنتقل الحالة من SEND_TO_USER_INBOX إلى PUBLISH_COMPLETE بعد نشر المنشئ من المسودة، وتشير TikTok إلى أن المسودة الواحدة قد تُنتج أكثر من منشور.
هل يرسل easyCoexistence المسودات؟
لا: تنشر publish_tiktok_post مباشرة. تستدعي /business/video/publish/ أو /business/photo/publish/ دون upload_to_draft أو is_draft، فيصبح المنشور فعليًا بعد أن تعالجه TikTok. ولحجز منشور للمراجعة، حدّد له موعد الجدولة بـscheduled_at، من دقيقة واحدة إلى 90 يومًا مقدمًا: ينتظر في قسم القادمة (Coming up) على شاشة المنشورات، ويغيّر update_scheduled_post موعده أو تعليقه أو عنوان منشور الصور، ويوقف cancel_scheduled_post نشره قبل أن يخرج.
الأخطاء الشائعة
- طلب video.publish لإرسال المسودات. المسودات تحتاج إلى video.upload، وهو النطاق الذي تصفه TikTok بمشاركة المحتوى كمسودة.
- ضبط تعليق على مسودة فيديو عبر API for Business. مع upload_to_draft بقيمة true، تتجاهل TikTok بقية حقول post_info كلها.
- رفع المسودات أسرع من نشر المنشئين لها. تتوقف Content Posting API عند 5 مشاركات معلقة خلال 24 ساعة، ويُرجع رمز الخطأ spam_risk_too_many_pending_share للتطبيق.
- ترك المستخدمين دون توجيه إلى الصندوق الوارد. تطلب TikTok من التطبيقات إخبار المستخدمين بفتح إشعار الصندوق الوارد لإتمام المنشور.
بين US$ 9 و US$ 0.75 لكل اتصال شهريًا، ينخفض مع إضافة الاتصالات، وأول 3 أيام مجانًا.
الأسئلة الشائعة
هل تستطيع واجهة TikTok البرمجية حفظ فيديو كمسودة؟
نعم. تضعه عملية الرفع في الصندوق الوارد للمنشئ على TikTok، حيث يعدّله وينشره، ويتطلب الأمر نطاق video.upload في الرمز.
أين تظهر المسودة المرسلة عبر الواجهة؟
في تطبيق TikTok، خلف إشعار في الصندوق الوارد يفتح الفيديو في محرر TikTok ليُنهيه المنشئ.
هل تحتفظ مسودة TikTok بالتعليق الخاص بي؟
في API for Business تحتفظ مسودة الصور بعنوانها وتعليقها، بينما تُسقط مسودة الفيديو بقية حقول post_info كلها.
هل يمكن لمسودة TikTok الواحدة أن تتحول إلى أكثر من منشور؟
نعم. تشير TikTok إلى أن المسودة الواحدة قد تُنتج أكثر من منشور، وفي Content Posting API تنتقل الحالة إلى PUBLISH_COMPLETE بعد نشر المنشئ منها.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في