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

كيف تنشر فيديو على TikTok عبر واجهة برمجة التطبيقات (API)

لنشر فيديو عبر واجهة برمجة التطبيقات الخاصة بـ TikTok للأعمال، أرسل طلب POST إلى /business/video/publish/ مع business_id الخاص بالحساب، و video_url بنطاق موثّق أو بادئة عنوان URL موثّقة، وكائن post_info يحمل الوصف والإعدادات، مع ترويسة Access-Token. يرد TikTok برمز share_id، فمرّره كقيمة publish_id إلى /business/publish/status/ حتى تصبح الحالة PUBLISH_COMPLETE ويظهر post_ids المقابل.

يتيح easyCoexistence نشر فيديوهات TikTok بالأداة publish_tiktok_post من Claude أو ChatGPT أو وكيلك الخاص: مرّر رابط HTTPS والوصف وما إذا كانت التعليقات مفعّلة، ثم تابع المنشور بالأداة get_tiktok_publish_status، بينما يصل الملف إلى TikTok عبر مسار الوسائط الموثّق.

share_id

يُعاد من استدعاء النشر، مثل v_pub_url~v1.2345123456789123456، ويُمرّر إلى استدعاء الحالة بوصفه publish_id.

Nov 16, 2023

ومنذ ذلك الحين، يرفض TikTok نشر الفيديوهات من عناوين URL لم يُوثّق نطاقها أو بادئتها.

6 a minute

حد TikTok لعدد منشورات الفيديو لكل حساب عبر نقطة النهاية (endpoint) للنشر، بحد أقصى 15 منشوراً يومياً.

3 min

المدة التي قد تستغرقها post_ids للظهور بعد PUBLISH_COMPLETE؛ ينصح TikTok بإعادة المحاولة بعد ثلاث دقائق.

post_id

يُرسَل الحدث post.publish.publicly_available عبر خطاف الويب (webhook) بعد اجتياز المنشور للمراجعة، فيصبح جاهزاً للاستعلام عن إحصاءاته.

ما الذي تحتاجه قبل الاستدعاء الأول؟

ثلاثة أشياء: رمز الوصول (token) الخاص بحساب TikTok وopen_id الخاص بالحساب الناتج عن تبادل الرمز؛ تطبيق مطوّر يمتلك إذن Video Publish ضمن قسم حسابات TikTok؛ والفيديو على عنوان URL عام يعمل ببروتوكول HTTPS أو HTTP ويقع تحت نطاق أو بادئة موثّقة للتطبيق. يحمّل TikTok الملف بنفسه، لذلك يجب أن يبقى متاحاً، وينصح TikTok بعنوان يبقى صالحاً لمدة 30 دقيقة على الأقل.

كيف يبدو طلب النشر؟

طلب POST إلى https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ مع token الحساب في ترويسة Access-Token، وضبط Content-Type على application/json. يسمّي جسم JSON الحساب في business_id، والملف في video_url، وإعدادات المنشور في post_info. يُظهر المثال التالي نشر فيديو مع وصف، مع ترك التعليقات وDuet وStitch مفعّلة:

Publish a video with curl
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/launch.mp4",
    "post_info": {
      "caption": "Our new menu is live #food",
      "is_brand_organic": false,
      "is_branded_content": false,
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false
    }
  }'

ماذا تفعل كل حقول الجسم؟

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

  • business_id: open_id الخاص بالحساب الناتج عن تبادل الرمز.
  • video_url: الملف الذي يحمّله TikTok، بصيغة MP4 أو MOV أو WebM، على نطاق أو بادئة عنوان URL موثّقة.
  • post_info: مطلوب في كل استدعاء ولو كان كائناً فارغاً، وهو موضع إعدادات المنشور.
  • post_info.caption: حتى 2,200 حرف محسوبة بترميز UTF-16، مع وسوم #hashtags وحتى 30 إشارة @.
  • post_info.is_brand_organic وis_branded_content: وسما المحتوى الترويجي والشراكة المدفوعة، واللذان يعدّهما جدول TikTok إلزاميين.
  • post_info.disable_comment وdisable_duet وdisable_stitch: القيمة true تعطّل التعليقات أو Duet أو Stitch، والقيم الافتراضية كلها false.

ماذا يعيد TikTok؟

الاستجابة المعتادة، مع معرّف مهمة النشر في data. الرمز 0 (code) يعني أن TikTok قبِل المهمة، لا أن الفيديو صار منشوراً: ما زال على TikTok تحميل الملف وفحصه وتدقيق المنشور. وفي أمثلة TikTok يبدأ share_id للفيديو بـ v_pub_url، ويبدأ share_id لمنشور الصور بـ p_pub_url فقط.

The publish response
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {
    "share_id": "v_pub_url~v1.2345123456789123456"
  }
}

كيف تتابع المنشور حتى يصبح متاحاً؟

بطلب GET إلى /business/publish/status/ مع تمرير business_id وshare_id بوصفه publish_id. تقرأ الحالة PROCESSING_DOWNLOAD أثناء جلب TikTok للملف، أو PUBLISH_COMPLETE بعد اجتياز المنشور للمراجعة، أو FAILED مع سبب. تظهر post_ids مع PUBLISH_COMPLETE عندما يصبح المنشور مرئياً للعموم، وقد تتأخر حتى ثلاث دقائق. الخطوات كلها بلغة Python:

Publish and follow a video in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"]  # open_id from the token exchange

def call(method, path, **kwargs):
    body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
    if body.get("code") != 0:  # errors arrive in code, usually with HTTP 200
        raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
    return body["data"]

share_id = call("POST", "business/video/publish/", json={
    "business_id": BUSINESS_ID,
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {"caption": "Our new menu is live #food",
                  "is_brand_organic": False, "is_branded_content": False},
})["share_id"]

for _ in range(30):
    time.sleep(60)  # each check is a call; TikTok's stages take minutes
    s = call("GET", "business/publish/status/",
             params={"business_id": BUSINESS_ID, "publish_id": share_id})
    if s["status"] == "FAILED":
        raise RuntimeError(s.get("reason"))
    if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
        print("Live:", s["post_ids"])
        break

هل يمكن لـ webhook أن يحل محل فحوص الحالة؟

نعم، بالنسبة إلى تطبيق يشترك في event_type بقيمة VIDEO عبر /business/webhook/update/. يرسل TikTok بعد ذلك الحدث post.publish.failed أو post.publish.complete بعد أن ينزّل الملف ويفحصه، والحدث post.publish.publicly_available مع post_id الجديد بعد اجتياز المراجعة، والحدث post.publish.no_longer_publicly_available إن خرج المنشور لاحقاً من العرض العام. يسمّي كل حدث المهمة في publish_id، وتطابق القيمة المذكورة في share_id تماماً.

كيف تنشر فيديو عبر MCP؟

اطلب ذلك بكلمات عادية من Claude أو ChatGPT أو أي عميل آخر متصل بـ https://easycoexistence.com/api/mcp. يستدعي المساعد الأداة publish_tiktok_post بـ account_id من list_social_accounts، وvideo_url بصيغة HTTPS، والوصف، وdisable_comment إن أردت إيقاف التعليقات. تعيد النتيجة share_id من TikTok، وتعيد الأداة get_tiktok_publish_status، عند تمرير account_id وذلك share_id، الحالة وpost_ids والسبب كما هي الآن.

The MCP tool calls and their results
publish_tiktok_post {
  "account_id": "<ACCOUNT_ID>",
  "video_url": "https://media.example.com/tiktok/launch.mp4",
  "caption": "Our new menu is live #food",
  "disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
     "note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }

get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }

ماذا يرسل publish_tiktok_post إلى TikTok؟

استدعاء إلى endpoint نفسه، مُعبّأ من طلبك. يُرسَل رابطك إلى TikTok كرابط موقّع عبر مسار الوسائط الموثّق الخاص بـ easyCoexistence، فلا يحتاج إلى توثيق منفصل. أما الوصف وdisable_comment فيُرسلان كما أعطيتهما، وتُرسل is_brand_organic وis_branded_content بالقيمة false. وتبقى الإعدادات الأخرى، مثل Duet وStitch والغلاف ووسم الذكاء الاصطناعي، على الافتراضيات التي يحددها TikTok، ويُنشر الفيديو منشوراً عاماً كما صُمّم الـ endpoint.

ماذا يمكنك أن تفعل ببيانات الاعتماد من Partner API؟

استدعاء TikTok مباشرة بالنيابة عن الحساب. يعيد GET /channels/{id}?credentials=1 على https://easycoexistence.com/api/v1، مع مفتاح ec_live_ بوصفه bearer token، القناة مع كائن credentials: api_base وbusiness_id وaccess_token حالي وtoken_expires_at. تُشغَّل بعد ذلك فحوص الحالة وقوائم الفيديو والتعليقات والإحصاءات من كودك. أما النشر فهو الجزء الذي ينبغي التخطيط له: يمرر الاستدعاء المباشر للنشر video_url إلى TikTok دون تعديل، وتُضاف خصائص URL بمعرّف التطبيق المطوَّر وسره الخاص، والبادئة التي وثّقها تطبيق easyCoexistence هي مسار الوسائط الخاص به، وهو المسار الذي تعتمد عليه أداة النشر الجاهزة.

Credentials from the Partner API, then a direct status check
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

# "credentials": {
#   "platform": "tiktok",
#   "api_base": "https://business-api.tiktok.com/open_api/v1.3",
#   "business_id": "<OPEN_ID>",
#   "access_token": "<ACCESS_TOKEN>",
#   "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }

curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'publish_id=<SHARE_ID>'

كيفية إعداده

  1. Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
  2. Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
  3. Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.

الأخطاء الشائعة

  • نسيان post_info. يشترطه TikTok في كل استدعاء، حتى عندما لا يتغير أي إعداد.
  • البحث عن معرّف المنشور في استجابة النشر. تعيد الاستجابة share_id فقط، وتأتي معرّفات المنشورات من استدعاء الحالة أو من حدث post.publish.publicly_available المُرسل عبر webhook الخاص بالتطبيق.
  • إعادة استدعاء النشر بعد انتهاء مهلة الطلب. ربما وصل الطلب الأول إلى TikTok، لذا راجع أحدث منشورات الحساب قبل إرساله مجدداً.
  • اعتبار الرمز 0 فيديو منشوراً. يعني أن TikTok قبِل المهمة، وقد يفشل الملف في فحوصه بعد التنزيل.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع أول 3 أيام مجانًا.

الأسئلة الشائعة

ما الـ endpoint الذي ينشر فيديو على منصة TikTok للأعمال؟

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ مع token الحساب في ترويسة Access-Token، وبالقيم business_id وvideo_url وpost_info في جسم الطلب بصيغة JSON.

هل تقبل واجهة TikTok رفع ملف الفيديو مباشرة؟

ليس عبر /business/video/publish/. يأخذ الاستدعاء video_url ويجلب الملف منه، لذا يلزم أن يكون للفيديو عنوان URL على نطاق أو بادئة موثّقة.

كيف أحصل على معرّف فيديو نُشر برمجياً؟

من post_ids في /business/publish/status/ بعد أن تصبح الحالة PUBLISH_COMPLETE ويصبح المنشور عاماً، أو من post_id في حدث post.publish.publicly_available عبر webhook المُعدّ للتطبيق.

هل يمكن جدولة فيديو على TikTok لوقت لاحق برمجياً؟

ينشر الـ endpoint عند استدعائه ولا يحتوي على حقل للوقت. يحتفظ easyCoexistence بالمنشورات المجدولة في طابور خاص به، ويستدعي TikTok في الوقت الذي تحدده.

تابع القراءة

إعدادات منشورات TikTok عبر API: الخصوصية والتعليقات وDuet وStitchإعدادات TikTok التي تقبلها نقاط النشر: الخصوصية والتعليقات وDuet وStitch والغلاف والوسوم، والقيم التي يسمح بها كل حساب.عناوين URL لوسائط TikTok: نطاقات وبادئات URL موثّقةكيف تسحب واجهة برمجة التطبيقات (API) من TikTok وسائط المنشورات من نطاقات وبادئات URL موثّقة عبر سجل DNS TXT وملف توقيع، ونقاط نهاية الممتلكات.كيفية متابعة حالة نشر منشور TikTok عبر واجهة برمجة التطبيقات (API)متابعة منشور TikTok المرسل عبر واجهة برمجة التطبيقات (API): share_id، والحالات PROCESSING_DOWNLOAD وPUBLISH_COMPLETE وFAILED، ومعرّفات المنشور وأسباب الفشل.متطلبات فيديو TikTok لواجهة برمجة التطبيقات (API): الصيغة والحجم والمدةالفيديوهات التي تنشرها TikTok API for Business: MP4 أو MOV أو WebM، من 3 إلى 600 ثانية، حتى 1 GB، و23 إلى 60 إطارًا في الثانية، من رابط يُنزله TikTok بنفسه.إعداد webhooks الخاصة بـ TikTok API for Businessكيف تشترك في webhooks لتطبيق TikTok API for Business عبر /business/webhook/update/ لأحداث الفيديو والتعليقات، مع التحقق من التوقيع.رموز وصول TikTok API for Business: 24 ساعة والتجديد والإلغاءشرح كيف تصدر واجهة TikTok API for Business رموز الحسابات: تبديل رمز التفويض، ورمز وصول مدته 24 ساعة، والتجديد والإلغاء.

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

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

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

تم التحقق في