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

رموز وصول TikTok API for Business: 24 ساعة والتجديد والإلغاء

رمز الوصول (token) في TikTok API for Business يدوم 24 ساعة ويُرسل في الترويسة Access-Token. يحصل عليه التطبيق بتبديل رمز التفويض الخاص بالمالك عند /tt_user/oauth2/token/، إلى جانب رمز تحديث صالح لعام واحد يجدد الوصول عند /tt_user/oauth2/refresh_token/. يُلغى الرمز عند /tt_user/oauth2/revoke/، وتُسرد النطاقات الممنوحة له عند /tt_user/token_info/get/ لعرض تفاصيلها.

تُبادل easyCoexistence رمز التفويض حين يسجّل حساب TikTok دخوله، وتجدد الرمز الذي مدته 24 ساعة قبل أن ينتهي، وتفحص الحساب تقريباً كل 6 ساعات، ليستدعي Claude أو ChatGPT أو شيفرتك TikTok برمز حالٍ يسلّمه get_social_credentials لسكريبتاتك.

24 hours

مدة صلاحية رمز الوصول لحساب TikTok؛ تذكر كل استجابة للرمز الثواني المتبقية في expires_in.

1 year

مدة صلاحية رمز التحديث الصادر معه؛ يعطي refresh_token_expires_in عدد الثواني المتبقية منه.

10 minutes

المدة التي يبقى فيها رمز التفويض في عنوان إعادة التوجيه صالحاً؛ ولا يمكن تبديله إلا مرة واحدة.

open_id

المعرّف الخاص بتطبيق الحساب، يُعاد مع كل رمز ويُرسل بوصفه business_id في استدعاءات Accounts API.

Bearer

نوع الرمز الذي تُعيده TikTok؛ من يحمل الرمز يستطيع الوصول إلى موارد الحساب.

creator_id

معرّف الحساب الذي يعيده /tt_user/token_info/get/ إلى جانب نطاق الرمز، ويصلح بوصفه business_id في استدعاءات Accounts API.

كيف يصل رمز التفويض إلى تطبيقك؟

عبر رابط تفويض صاحب حساب TikTok، الذي تولّده TikTok لتطبيق المطور ضمن My Apps ثم App Detail ثم Basic Information بعد أن يحصل التطبيق على صلاحية TikTok Accounts. يفتح المالك الرابط ويراجع الصلاحيات ويوافق عليها. ثم توجّه TikTok المتصفح إلى عنوان إعادة التوجيه الخاص بالتطبيق مع auth_code ملحقاً به، ومع أي قيمة state حملها رابط التفويض، ويكون الرمز صالحاً لمدة 10 دقائق ولتبديل واحد فقط.

  • عنوان إعادة التوجيه: مطلق يبدأ بـ https:// وينتهي بـ /، دون سلسلة استعلام أو مرساة أو منفذ، وطوله بين 10 و512 حرف.
  • حتى 10 عناوين لإعادة التوجيه لكل تطبيق، واحد نشط في كل مرة؛ وتفعيل أحدها يولّد رابط تفويض خاصاً به.
  • state: قيمة اختيارية تعيدها TikTok في إعادة التوجيه، وتقترحها للحماية من CSRF.
  • disable_auto_auth=1: يعرض صفحة المراجعة لمالكين وافقوا على الصلاحيات نفسها من قبل، وإلا فإن TikTok توجّههم فوراً.

كيف تُبادل الرمز برموز الوصول؟

بطلب POST إلى /tt_user/oauth2/token/ من خادمك، بصيغة JSON. client_id وclient_secret هما معرّف التطبيق والمفتاح السري المعروضان ضمن My Apps ثم App Detail ثم Basic Information؛ وgrant_type قيمته authorization_code؛ وauth_code هو الرمز القادم من إعادة التوجيه؛ ويجب أن يساوي redirect_uri عنوان إعادة التوجيه الخاص بصاحب حساب TikTok المضبوط في التطبيق.

Exchange the authorization code
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/token/' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "<APP_ID>",
    "client_secret": "<APP_SECRET>",
    "grant_type": "authorization_code",
    "auth_code": "<AUTH_CODE>",
    "redirect_uri": "https://app.example.com/tiktok/callback/"
  }'

ماذا تحتوي استجابة الرمز؟

كائن JSON يضم code وmessage وrequest_id وdata. القيمة 0 في code تعني أن التبديل نجح، وdata تحمل الرمزين ومعرّف الحساب:

  • access_token: الرمز قصير الأمد لاستدعاءات API، وصلاحيته يوم واحد.
  • token_type: القيمة Bearer، وتصفها TikTok بأنها قابلة للاستخدام من أي شخص يحمل الرمز.
  • scope: الصلاحيات الممنوحة للرمز، في سلسلة واحدة مفصولة بفواصل.
  • expires_in: عدد الثواني المتبقية قبل انتهاء رمز الوصول، وهي 86400 في مثال TikTok.
  • refresh_token: الرمز الذي يجدد الوصول، وصلاحيته سنة واحدة، وتوصي TikTok بالاحتفاظ به.
  • refresh_token_expires_in: عدد الثواني المتبقية قبل انتهاء رمز التحديث.
  • open_id: المعرّف الخاص بالتطبيق لحساب TikTok.
A token response (scope shortened)
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "access_token": "<ACCESS_TOKEN>",
    "token_type": "Bearer",
    "scope": "user.info.basic,user.info.stats,user.insights,video.list,video.insights,video.publish,comment.list,comment.list.manage",
    "expires_in": 86400,
    "refresh_token": "<REFRESH_TOKEN>",
    "refresh_token_expires_in": 31536000,
    "open_id": "<OPEN_ID>"
  }
}

كيف يُرسل الرمز مع استدعاءات API؟

في ترويسة طلب اسمها Access-Token، على نقاط النهاية (endpoint) في Accounts API من /business/get/ إلى /business/video/publish/، بينما يُذكر الحساب نفسه في business_id، ويُضبط على open_id من الاستجابة ذاتها. أما مسارات OAuth فتعمل بالعكس: /tt_user/oauth2/token/ و/tt_user/oauth2/refresh_token/ و/tt_user/oauth2/revoke/ تأخذ client_id وclient_secret للتطبيق في جسم JSON، ولا تُرسل ترويسة Access-Token.

كيف تجدد رمز الوصول؟

بطلب POST إلى /tt_user/oauth2/refresh_token/ يحمل client_id وclient_secret وgrant_type بقيمة refresh_token، والرمز refresh_token المحفوظ. تحمل الإجابة الحقول نفسها في التبديل الأول: access_token جديد مع expires_in، وrefresh_token تحتفظ به للتجديد التالي، والثواني المتبقية له. اجدول التجديد قبل مرور 24 ساعة بدل انتظار الخطأ 40102 قبل أن تجدده.

Renew a TikTok account access token in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"

def renew(refresh_token: str) -> dict:
    r = requests.post(f"{API}/tt_user/oauth2/refresh_token/", json={
        "client_id": os.environ["TIKTOK_APP_ID"],
        "client_secret": os.environ["TIKTOK_APP_SECRET"],
        "grant_type": "refresh_token",
        "refresh_token": refresh_token,
    }, timeout=30).json()
    if r["code"] != 0:  # 40103: the refresh token expired, so the owner authorizes again
        raise RuntimeError(f"{r['code']}: {r['message']}")
    d, now = r["data"], time.time()
    return {
        "access_token": d["access_token"],
        "access_expires_at": now + d["expires_in"],
        "refresh_token": d["refresh_token"],  # keep it for the next renewal
        "refresh_expires_at": now + d["refresh_token_expires_in"],
    }

كيف تُلغى الصلاحية؟

من التطبيق، بطلب POST إلى /tt_user/oauth2/revoke/ يحمل client_id وclient_secret وaccess_token المراد إلغاؤه، وينجح الطلب بإعادة code بقيمة 0 مع كائن data فارغ. ومن جهة الحساب، يفتح المالك تطبيق TikTok ثم ينتقل إلى Settings and privacy ثم Security ثم Manage app permissions، فيختار التطبيق ويضغط Remove access. وبعد إلغاء التفويض تتوقف TikTok عن إرسال أحداث comment.update للتطبيق بشأن ذلك الحساب.

Revoke a TikTok account access token
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/revoke/' \
  -H 'Content-Type: application/json' \
  -d '{"client_id": "<APP_ID>", "client_secret": "<APP_SECRET>", "access_token": "<ACCESS_TOKEN>"}'

# {"code": 0, "message": "OK", "request_id": "<REQUEST_ID>", "data": {}}

كيف تفحص الرمز؟

بطلب POST إلى /tt_user/token_info/get/، ولا يحتاج إلى صلاحية خاصة به: أرسل app_id وaccess_token، فتعيد data الحقول app_id وscope وcreator_id. يسرد scope الصلاحيات التي منحها المالك، وcreator_id هو المعرّف الخاص بالتطبيق للحساب، وهو القيمة التي تأخذها استدعاءات Accounts API بوصفها business_id. وتحيل مراجع TikTok المطورين إلى هذا المسار كلما احتاج حقل إلى صلاحية قد لا يملكها الرمز.

ما الأخطاء المرتبطة بالرموز؟

تضعها TikTok في حقل code من الاستجابة، غالباً تحت حالة HTTP 200، لذا تحقق من code قبل أن تثق باستدعاء. رموز الأخطاء المرتبطة بالرموز وبتبديلها:

  • 40102: انتهت صلاحية رمز الوصول؛ جدّده ثم أعد الاستدعاء.
  • 40103: انتهت صلاحية رمز التحديث؛ لا يستبدله إلا تفويض جديد من المالك.
  • 40104: لم يحمل الطلب رمز وصول.
  • 40105: رمز الوصول غير صالح أو غير صحيح.
  • 40107: رمز التحديث غير صالح أو غير صحيح، مثل رمز أُرسل لتجديد رمز Marketing API، وهو لا ينتهي أبداً.
  • 40110: أُلغي رمز التفويض أو استُخدم سابقاً أو انتهت صلاحيته.
  • 40131: خطأ مصادقة في مساري الرموز، بسبب معرّف تطبيق أو مفتاح سري خاطئ، أو رمز تفويض منتهٍ، أو رمز تحديث غير صالح أو منتهٍ.

ماذا تجدد easyCoexistence عنك؟

كل شيء بعد تسجيل الدخول. تبدّل easyCoexistence الرمز فور عودة TikTok إلى easyCoexistence، وتخزّن الرمزين مشفّرَين، وتجدد رمز الوصول بنفسها: قبل أي استدعاء عندما يبقى أقل من 15 دقيقة، وأثناء الفحص الذي تجريه على كل حساب تقريباً كل 6 ساعات عندما يبقى أقل من 8 ساعات. كل تجديد يخزّن رمز التحديث الجديد وانتهاء صلاحيته، والاستدعاءات التي تصل معاً تتشارك تجديداً واحداً.

  • رمز مرفوض: عندما ترد TikTok بالخطأ 40102 أو 40104 أو 40105، يُعلَّم الاتصال لإعادة الربط ويتلقى المالك بريداً إلكترونياً؛ ويتلقى مستخدمو Partner API الحدث channel.disconnected أيضاً.
  • شيفرتك الخاصة: تعيد الدالة get_social_credentials، أو GET /channels/{id}?credentials=1 في Partner API، الرمز الحالي مع token_expires_at، لذا اجلبه لكل مهمة على حدة.
  • الإزالة: إزالة الاتصال من لوحة التحكم، أو بالطلب DELETE /channels/{id}، تُلغي الرمز لدى TikTok عبر /tt_user/oauth2/revoke/.

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

  • تبديل رمز التفويض في المتصفح. يرسل التبديل client_secret الخاص بالتطبيق، لذا أجره من خادمك، خلال 10 دقائق من إعادة التوجيه.
  • قراءة expires_in كتاريخ. فهو يحمل الثواني المتبقية، لذا أضفه إلى وقت الاستجابة لتعرف متى ينتهي الرمز.
  • الإلغاء برمز التحديث. يطلب /tt_user/oauth2/revoke/ الحقل access_token مع client_id وclient_secret الخاصين بالتطبيق.
  • اعتبار غياب شاشة الموافقة فشلاً. تتخطى TikTok صفحة المراجعة للصلاحيات التي وافق عليها المالك من قبل؛ أضف disable_auto_auth=1 لإظهارها من جديد.
إنجاز ذلك باستخدام EasyCoexistence

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

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

كم تدوم رموز الوصول لـ TikTok API for Business؟

24 ساعة. تعطي كل استجابة للرمز الثواني المتبقية في expires_in، ويجدده رمز التحديث الصالح لعام.

هل تحتاج نقطة نهاية التجديد في TikTok إلى redirect_uri؟

جدول المعاملات فيها يذكر client_id وclient_secret وgrant_type وrefresh_token، دون redirect_uri، مع أن دليل المصادقة في TikTok يقول إن مسارات الرموز تشترط redirect_uri.

هل يوقف إلغاء رمز TikTok خطافات الويب (webhook) الخاصة به؟

نعم. لا ترسل TikTok إلى التطبيق أحداث comment.update لذلك الحساب، حتى يفوّض المالك التطبيق من جديد.

من أين يأتي business_id في TikTok؟

من open_id في استجابة الرمز، وهو القيمة التي تأخذها استدعاءات Accounts API بوصفها business_id. ويعيد /tt_user/token_info/get/ المعرّف نفسه في الحقل creator_id.

تابع القراءة

نطاقات TikTok API for Business: ما يفتحه كل إذنالأذونات التي تعمل بها TikTok Accounts API بأسمائها الرسمية: ما تفتحه كل منها، ونطاقات الرمز لكل حقل، وكيفية التحقق من الرمز.خطأ TikTok 40102: انتهاء صلاحية رمز الوصوليعني الخطأ 40102 في TikTok انتهاء صلاحية رمز الوصول. تبقى رموز Accounts API يوماً واحداً، وهذه طريقة تجديدها ومتى تعيد ربط الحساب.خطأ TikTok 40103: انتهت صلاحية رمز التحديثخطأ TikTok 40103: رمز التحديث منتهٍ فلا يمكن تجديد الوصول. رموز تحديث Accounts API تدوم سنة، والحل تفويض جديد.TikTok API for Business مقابل Content Posting APIلماذا TikTok API for Business بدلًا من developers.tiktok.com: التعليقات والتحليلات وتجديد رموز الوصول.إعداد webhooks الخاصة بـ TikTok API for Businessكيف تشترك في webhooks لتطبيق TikTok API for Business عبر /business/webhook/update/ لأحداث الفيديو والتعليقات، مع التحقق من التوقيع.كيف تنشر فيديو على TikTok عبر واجهة برمجة التطبيقات (API)انشر فيديو على TikTok عبر واجهة TikTok للأعمال، مع نقطة النشر وجسم JSON وshare_id المُعاد وطلب الحالة، بأمثلة curl وPython.

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

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

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

تم التحقق في