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

خطأ TikTok 40102: انتهاء صلاحية رمز الوصول

يعني الخطأ 40102 أن رمز الوصول (access token) المُرسل مع الطلب انتهت صلاحيته، ويجب استدعاء نقطة النهاية (endpoint) بأحدث رمز. تبقى رموز الوصول في Accounts API صالحة ليوم واحد. لتجديدها، أرسل رمز التحديث (refresh token) إلى /tt_user/oauth2/refresh_token/ ثم أعد الطلب. أما رمز التحديث نفسه فيبقى صالحاً لمدة عام، وبعدها يعيد مالك الحساب تفويض التطبيق.

يجدد easyCoexistence رمز TikTok الذي تبلغ مدته 24 ساعة بنفسه باستخدام رمز التحديث، قبل انتهائه، فتخرج الاستدعاءات من Claude أو ChatGPT أو من كودك الخاص برمز حديث.

40102

رمز الإرجاع من TikTok لرمز وصول منتهي الصلاحية؛ يجب استدعاء endpoint بأحدث رمز.

1 day

المدة التي يبقى فيها رمز وصول حساب TikTok من Accounts API صالحاً.

86,400

قيمة expires_in بالثواني في مثال TikTok لرمز وصول صدر حديثاً.

1 year

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

ماذا يعني الخطأ 40102؟

الرمز الموجود في الترويسة Access-Token تجاوز تاريخ انتهائه. تدرج وثيقة رموز الإرجاع لدى TikTok الرمز 40102 بوصفه رمز وصول منتهياً، وتنص على وجوب استدعاء endpoint بأحدث رمز. ويكون الحل باستخدام رمز وصول صالح ثم إعادة المحاولة.

يرد الرمز في نص الاستجابة. تعيد معظم استدعاءات TikTok API for Business الحالة HTTP 200، ويحدد رمز الإرجاع، لا الحالة، ما إذا نجح الاستدعاء.

كم يبقى رمز وصول TikTok صالحاً؟

يوماً واحداً في API for Business. تصدر Accounts API رمز وصول لحساب TikTok عندما يستبدل التطبيق رمز التفويض عند /tt_user/oauth2/token/، وتحدد الاستجابة مدته في expires_in، أي 86,400 ثانية في مثال TikTok. تحمل الاستجابة نفسها رمز تحديث صالحاً لمدة عام، وتنصح TikTok بالاحتفاظ به لتجديد رمز الوصول. أما رموز وصول المستخدم في TikTok for Developers، التي تستخدمها Content Posting API، فتبقى ساعتين بدلاً من ذلك.

كيف تجدده؟

أرسل رمز التحديث إلى /tt_user/oauth2/refresh_token/ مع معرّف التطبيق وسرّه، وحدد grant_type بالقيمة refresh_token. تتضمن الاستجابة رمز وصول جديداً ورمز تحديث جديداً: احفظهما، وأرسل رمز الوصول الجديد في الترويسة Access-Token من الآن فصاعداً، ثم أعد الاستدعاء الذي فشل. التجديد قبل انتهاء اليوم يمنع وصول الاستدعاءات إلى TikTok برمز منتهٍ أصلاً.

Renew a TikTok account access token
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "<APP_ID>",
    "client_secret": "<SECRET>",
    "grant_type": "refresh_token",
    "refresh_token": "<REFRESH_TOKEN>"
  }'

# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_in

متى يلزم أن يفوّض المالك من جديد؟

عندما يتعذر التجديد. رمز التحديث صالح لمدة عام، وتقول وثائق TikTok إنه بعد انتهائه يطلب المطور من مالك الحساب تفويض التطبيق مجدداً عبر مسار التفويض. ويمكن للمالك كذلك إلغاء التفويض في أي وقت من تطبيق TikTok، من الإعدادات والخصوصية ثم الأمان ثم إدارة أذونات التطبيق، وعندها يكون التفويض الجديد هو طريق العودة.

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

  • التجديد فقط بعد فشل الاستدعاء. الرمز الذي يعيش يوماً واحداً ينتهي يومياً، لذا جدده مسبقاً، وامنع وصول الاستدعاءات إلى TikTok برمز قديم.
  • تجاهل رمز التحديث في استجابة التجديد. تنص مرجعية TikTok على الاحتفاظ به للتجديد التالي، لذا احفظ الرمز الذي يعيده كل تجديد.
  • الاكتفاء بفحص الحالة HTTP. ترد TikTok غالباً بالحالة HTTP 200 وتضع 40102 في حقل الرمز، لذا يقرأ فحص الحالة وحده الفشل على أنه نجاح.
  • الاحتفاظ بنسخ من الرمز في أماكن متعددة. تجديد نسخة واحدة يترك البقية تبلغ نهاية يومها وتفشل بالخطأ 40102.
إنجاز ذلك باستخدام EasyCoexistence

وإذا رفضت TikTok الرمز رغم ذلك بالخطأ 40102 أو 40104 أو 40105، يُعلَّم الاتصال فوراً لإعادة الربط، ويصلك بريد إلكتروني. ويمكن لكودك جلب الرمز الحالي من get_social_credentials بدلاً من الاحتفاظ بنسخة منه. من US$ 9 حتى US$ 0.75 لكل اتصال شهرياً، ينخفض مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام تبدأ من أول اتصال.

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

ما الذي تعنيه القيمة expires_in في ردّ TikTok على طلب الرمز؟

هي عدد الثواني المتبقية على انتهاء رمز الوصول، وهي 86,400 ثانية، أي يوم كامل، في مثال TikTok لرمز Accounts API جديد. أضف هذه المدة إلى وقت الاستجابة لتعرف موعد التجديد قبل ظهور الخطأ 40102.

هل يمكن تجديد رمز وصول TikTok منتهي الصلاحية؟

نعم، ما دام رمز التحديث صالحاً. أرسله إلى /tt_user/oauth2/refresh_token/، فتعيد TikTok رمز وصول جديداً مع رمز تحديث.

هل يعني الخطأ 40102 وجوب إعادة ربط الحساب؟

ليس بذاته. يكفي رمز تحديث صالح لتجديد الوصول دون مالك الحساب، ولا يلزم تفويض جديد إلا إذا انتهت صلاحية رمز التحديث أو ألغى المالك الوصول.

لماذا تحمل استجابة بحالة HTTP 200 خطأ 40102 في حقل الرمز؟

لأن رموز الإرجاع من TikTok تتقدم على حالة HTTP. لا ينجح الاستدعاء إلا إذا كان رمزه 0، مهما كان سطر الحالة.

تابع القراءة

خطأ TikTok 40105: رمز الوصول غير صالح أو غير صحيحيعني الخطأ 40105 من TikTok أن رمز الوصول غير صالح أو غير صحيح. ما الذي تتحقق منه، وكيف تجدده، ومتى يجب على المالك إعادة التفويض.خطأ TikTok 40104: رمز الوصول فارغخطأ 40104 في TikTok يعني أن الطلب وصل إلى API بدون رمز وصول. تعرّف على مكان إرسال الرمز في Accounts API وكيف يضيع.خطأ TikTok 40103: انتهت صلاحية رمز التحديثخطأ TikTok 40103: رمز التحديث منتهٍ فلا يمكن تجديد الوصول. رموز تحديث Accounts API تدوم سنة، والحل تفويض جديد.خطأ TikTok 40131: خطأ مصادقة عند نقاط نهاية الرموزخطأ TikTok 40131 خطأ مصادقة عند الحصول على رمز الوصول أو تجديده، بسبب معرّف تطبيق أو مفتاح سري غير صحيح، أو رمز تفويض منتهٍ، أو رمز تجديد غير صالح.خطأ TikTok 40001: لا توجد صلاحية لتنفيذ العمليةيعني الخطأ 40001 في TikTok أن الاستدعاء لا يملك صلاحية العملية. كيف تتحقق من صلاحية تطبيقك في TikTok Accounts ونطاقات الرمز.TikTok API for Business مقابل Content Posting APIلماذا TikTok API for Business بدلًا من developers.tiktok.com: التعليقات والتحليلات وتجديد رموز الوصول.

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

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

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

تم التحقق في