تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

إرسال فيديو إلى مسودات المنشئ على 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 يومًا مقدمًا، ويبقى كل منشور في قائمة الانتظار ظاهرًا في شاشة المنشورات حتى يخرج.

video.upload

نطاق تعرّفه TikTok بأنه مشاركة المحتوى إلى حساب المنشئ كمسودة لمزيد من التحرير والنشر داخل التطبيق.

5 pending

أكبر عدد من المشاركات المعلقة تسمح به Content Posting API خلال أي فترة مدتها 24 ساعة، وهو حد تضعه TikTok للحد من المحتوى المزعج.

SEND_TO_USER_INBOX

تُبلّغ الحالة /business/publish/status/ بمجرد رفع المسودة وإشعار TikTok لصندوق وارد المنشئ.

6 a minute

في Content Posting API، عدد الطلبات التي يستطيع كل رمز الوصول (token) للمستخدم إرسالها إلى نقطة النهاية (endpoint) الخاصة بالرفع.

Ignored

ما يحدث لبقية حقول post_info حين تكون upload_to_draft بقيمة true على مسار /business/video/publish/ الخاص بالفيديو.

كيف تختلف المسودة عن المنشور المباشر؟

يكمن الفرق في من يضغط زر النشر. المنشور المباشر يصبح منشورًا فعليًا بعد أن تعالجه TikTok، أما المسودة فتصل إلى صندوق وارد المنشئ في TikTok، ولا تُنشر إلا حين يفتحها المنشئ ويعدّلها كما يشاء وينشرها. ويظهر الفرق في واجهتي النشر لدى TikTok:

Draft (upload)Direct post
Who postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent 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 من التطبيقات أن تُخبر المستخدمين بفتح إشعار الصندوق الوارد لمواصلة التحرير داخل التطبيق:

Upload a video to the creator's inbox from a URL
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، ويجد المنشئ المسودة عبر إشعار الصندوق الوارد:

Send a video to the creator's drafts on the API for Business
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 من التطبيقات إخبار المستخدمين بفتح إشعار الصندوق الوارد لإتمام المنشور.
إنجاز ذلك باستخدام EasyCoexistence

بين 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 بعد نشر المنشئ منها.

تابع القراءة

إعدادات منشورات TikTok عبر API: الخصوصية والتعليقات وDuet وStitchإعدادات TikTok التي تقبلها نقاط النشر: الخصوصية والتعليقات وDuet وStitch والغلاف والوسوم، والقيم التي يسمح بها كل حساب.كيفية متابعة حالة نشر منشور TikTok عبر واجهة برمجة التطبيقات (API)متابعة منشور TikTok المرسل عبر واجهة برمجة التطبيقات (API): share_id، والحالات PROCESSING_DOWNLOAD وPUBLISH_COMPLETE وFAILED، ومعرّفات المنشور وأسباب الفشل.لماذا تبقى منشورات TikTok عبر واجهة برمجة التطبيقات (API) خاصة: unaudited_client_can_only_post_to_private_accountsلماذا تبقى منشورات Content Posting API على TikTok خاصة حتى اجتياز التدقيق، ومعنى خطأ 403، وكيف تختلف عنها API for Business في النشر العام.كيف تنشر فيديو على TikTok عبر واجهة برمجة التطبيقات (API)انشر فيديو على TikTok عبر واجهة TikTok للأعمال، مع نقطة النشر وجسم JSON وshare_id المُعاد وطلب الحالة، بأمثلة curl وPython.عناوين URL لوسائط TikTok: نطاقات وبادئات URL موثّقةكيف تسحب واجهة برمجة التطبيقات (API) من TikTok وسائط المنشورات من نطاقات وبادئات URL موثّقة عبر سجل DNS TXT وملف توقيع، ونقاط نهاية الممتلكات.أسباب فشل النشر في TikTok: spam_risk_too_many_posts وpicture_size_check_failed وغيرهامعنى أسباب فشل النشر في TikTok وكيفية إصلاح كل سبب، مثل spam_risk_too_many_posts وpicture_size_check_failed وvideo_pull_failed وغيرها.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في