خطأ TikTok 40110: رمز التفويض غير صالح
يعني الخطأ 40110 من TikTok أن رمز التفويض المرسل إلى /tt_user/oauth2/token/ غير صالح: إما أنه أُلغي، أو سبق استخدامه، أو انتهت صلاحيته. رمز التفويض في واجهة برمجة التطبيقات (API) للحسابات يبقى صالحاً لمدة 10 دقائق ويعمل مرة واحدة فقط. الحل هو رمز جديد، لذا أعِد توجيه مالك الحساب إلى رابط التفويض مرة أخرى، واستبدله فوراً.
تُشغّل easyCoexistence تفويض TikTok عنك: تسجّل الدخول بحساب TikTok من لوحة التحكم، ويُستبدل الرمز فور إعادتك من TikTok.
رمز الإرجاع من TikTok لرمز تفويض أُلغي أو سبق استخدامه أو انتهت صلاحيته.
مدة صلاحية رمز تفويض Accounts API، مقابل ساعة واحدة لرمز Marketing API.
عدد المرات التي يُستبدل فيها رمز التفويض برمز الوصول (token).
عدد عناوين URL لإعادة توجيه حساب TikTok التي يمكن لتطبيق مطور واحد ضبطها، مع نشط واحد في كل مرة.
ماذا يعني الخطأ 40110؟
رفضت TikTok رمز التفويض الذي أُرسل بوصفه auth_code إلى المسار /tt_user/oauth2/token/ لأنه غير صالح. يذكر ملحق رموز الإرجاع ثلاثة أسباب: أُلغي الرمز، أو سبق استخدامه، أو انتهت صلاحيته. رسالته النموذجية هي «The auth_code is canceled. Please re-authorize and try again with a new auth_code.» وأياً كان السبب، فالحل واحد: رمز صالح.
ما مدة صلاحية رمز التفويض؟
صلاحيته 10 دقائق في واجهة Accounts API، ويمكن استخدامه مرة واحدة فقط. تضيفه TikTok إلى عنوان إعادة التوجيه كمعامل استعلام (query parameter) حين يوافق مالك الحساب على التفويض، وبانتهاء صلاحيته تبدأ خطوات التفويض من جديد. رموز Marketing API تبقى صالحة ساعة واحدة، وهذا يستحق الانتباه إذا أُعيد استخدام شيفرة كُتبت لتلك الواجهة هنا.
كيف يُستخدم الرمز مرتين؟
ينتقل الرمز عبر عنوان إعادة التوجيه، لذلك يمكن لأي شيء يعيد تحميل هذا العنوان أو يكرر الاستبدال أن يحاول استهلاكه مرة ثانية:
- تُعاد تحميل صفحة الاستدعاء العكسي أو يفتحها المتصفح مرتين، وكل تحميل يرسل الرمز نفسه.
- إعادة المحاولة تكرر طلب token بعد انتهاء المهلة الزمنية، مع أن المحاولة الأولى ربما نجحت.
- جزءان من التطبيق، مثل المتصفح والخادم، يستبدلان الرمز كلاهما.
كيف تُصلح الخطأ؟
ابدأ تفويضاً جديداً. أعد توجيه مالك حساب TikTok إلى رابط التفويض؛ فإن كان قد وافق على الأذونات نفسها من قبل، تتخطى TikTok صفحة المراجعة افتراضياً وتعيده مباشرة برمز جديد. استبدل الرمز مرة واحدة، خلال 10 دقائق، على الخادم، مع ضبط redirect_uri على عنوان إعادة التوجيه المضبوط في التطبيق، ثم خزّن الـ tokens التي تعيدها.
الأخطاء الشائعة
- الاحتفاظ بالرمز لوقت لاحق. مدته 10 دقائق، لذا استبدله فور وصول إعادة التوجيه.
- إعادة المحاولة بالرمز نفسه بعد الخطأ 40110. يبقى الرمز ملغى أو مستخدماً أو منتهياً، ولا يعطي التفويض الجديد سوى رمز يعمل.
- إضافة معاملات استعلام إلى عنوان إعادة التوجيه. تريد TikTok عنوان URL ثابتاً بصيغة HTTPS وينتهي بشرطة مائلة، وتُنقل أي قيم يحتاجها التطبيق في معامل state.
- إرسال redirect_uri يختلف عن المضبوط في التطبيق. تشترط نقطة النهاية الخاصة بالرموز (token endpoint) أن يكونا متطابقين.
إذا لم يكتمل تسجيل الدخول، فإن بدئه من جديد من لوحة التحكم يعطيك رمزاً جديداً، ويعمل Claude أو ChatGPT أو الشيفرة الخاصة بك بعدها مع الحساب المتصل. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية لمدة 3 أيام تبدأ من أول اتصال.
الأسئلة الشائعة
لماذا تقول TikTok إن auth_code أُلغي؟
هذه رسالة TikTok النموذجية للخطأ 40110: «The auth_code is canceled. Please re-authorize and try again with a new auth_code.» أُلغي الرمز أو سبق استخدامه أو انتهت صلاحيته، ولا يعطي سوى تفويض جديد رمزاً يعمل.
هل يمكن إعادة استخدام رمز تفويض TikTok؟
لا. يمكن استبدال كل رمز مرة واحدة، والرمز الذي سبق استخدامه هو أحد الأسباب التي تذكرها TikTok للخطأ 40110.
هل يجب على مالك الحساب الموافقة على كل إذن من جديد؟
ليس افتراضياً. تتخطى TikTok صفحة المراجعة للأذونات التي وافق عليها المالك من قبل، إلا إذا كان رابط التفويض يتضمن المعامل disable_auto_auth=1 ضمن معاملاته.
ما الفرق بين الخطأ 40110 و40131؟
يتعلق الخطأ 40110 برمز التفويض وحده. أما 40131 فهو خطأ مصادقة أوسع عند نقاط نهاية الرموز، وتشمل أسبابه الرمز المنتهي وكذلك معرّف التطبيق أو سره الخاطئ.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في