خطأ TikTok 40102: انتهاء صلاحية رمز الوصول
يعني الخطأ 40102 أن رمز الوصول (access token) المُرسل مع الطلب انتهت صلاحيته، ويجب استدعاء نقطة النهاية (endpoint) بأحدث رمز. تبقى رموز الوصول في Accounts API صالحة ليوم واحد. لتجديدها، أرسل رمز التحديث (refresh token) إلى /tt_user/oauth2/refresh_token/ ثم أعد الطلب. أما رمز التحديث نفسه فيبقى صالحاً لمدة عام، وبعدها يعيد مالك الحساب تفويض التطبيق.
يجدد easyCoexistence رمز TikTok الذي تبلغ مدته 24 ساعة بنفسه باستخدام رمز التحديث، قبل انتهائه، فتخرج الاستدعاءات من Claude أو ChatGPT أو من كودك الخاص برمز حديث.
رمز الإرجاع من TikTok لرمز وصول منتهي الصلاحية؛ يجب استدعاء endpoint بأحدث رمز.
المدة التي يبقى فيها رمز وصول حساب TikTok من Accounts API صالحاً.
قيمة expires_in بالثواني في مثال TikTok لرمز وصول صدر حديثاً.
المدة التي يبقى فيها رمز التحديث صالحاً؛ بعد انتهائها يعيد مالك الحساب تفويض التطبيق.
ماذا يعني الخطأ 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 برمز منتهٍ أصلاً.
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.
وإذا رفضت 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، مهما كان سطر الحالة.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في