خطأ TikTok 40104: رمز الوصول فارغ
يعني الخطأ 40104 أن الطلب وصل بدون رمز وصول. تتوقع نقاط النهاية (endpoint) في Accounts API، مثل /business/video/list/ و/business/comment/list/، أن يأتي رمز حساب TikTok في ترويسة (header) طلب اسمها Access-Token، وهي ترويسة إلزامية. أضف هذه الترويسة برمز صالح، من /tt_user/oauth2/token/ أو جدّده بواسطة رمز التجديد، ثم أعد إرسال الطلب.
يضيف easyCoexistence الرمز الحالي لحساب TikTok، في ترويسة Access-Token، إلى كل استدعاء يجريه لـ Claude أو ChatGPT أو كودك الخاص.
رمز الخطأ من TikTok عند فراغ رمز الوصول، والحل هو إرسال رمز صالح.
الترويسة المطلوبة التي تحمل رمز حساب TikTok في نقاط نهاية Accounts API.
المعامل business_id الذي يحدد حساب TikTok في كل استدعاء، ويُضبط على open_id المُعاد مع رمزه.
نوع الرمز token_type الذي تعيده TikTok لرمز حساب TikTok، ومع ذلك يُرسل في Access-Token، كما في سائر الطلبات.
ماذا يعني الخطأ 40104؟
تلقّت TikTok الاستدعاء دون أي رمز وصول. تدرج قائمة رموز الإرجاع الخطأ 40104 على أنه رمز وصول فارغ، والحل هو نفسه في أخطاء الرموز الأخرى: استخدم رمز وصول صالحا وحاول مرة أخرى. وصل الطلب إلى TikTok، لكن لم يكن فيه ما يدل على التفويض الذي يتصرف بموجبه، فتعامل معه TikTok على أنه غير ناجح.
أين يوضع الرمز؟
في ترويسة طلب اسمها Access-Token. تدرج مراجع Accounts API، من النشر إلى التعليقات والتحليلات، الترويسة Access-Token بوصفها حقلا إلزاميا يحمل الرمز الذي فوّضه حساب TikTok. أما الحساب نفسه فيُذكر بشكل منفصل في business_id، ويُضبط على open_id الذي عاد مع الرمز.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","caption","video_views"]'كيف تصبح الترويسة فارغة؟
يضيع الرمز في مكان ما بين التخزين والطلب. هذه أماكن البحث:
- الترويسة تحمل اسما آخر. الرمز المُرسل كـ Authorization: Bearer يترك Access-Token فارغة، رغم أن TikTok تعطي نوع الرمز Bearer.
- المتغير الذي يحمل الرمز فارغ، مثلاً بعد تجديد فشل دون التحقق من خطئه.
- الرمز يُرسل في الجسم أو في سلسلة الاستعلام بدل الترويسة.
- تُعاد استخدام دالة كُتبت لـ /
tt_user/oauth2/token/ و/tt_user/oauth2/refresh_token/؛ هذه النقاط لا تأخذ ترويسة Access-Token، فتُرسل الدالة بلا ترويسة.
كيف تصلحه؟
أرسل الرمز في Access-Token مع business_id. إن لم يكن هناك رمز حالي، فاحصل عليه: جدّده عبر /tt_user/oauth2/refresh_token/ ما دام رمز التجديد صالحا، أو اطلب من صاحب الحساب أن يفوّض التطبيق من جديد إن لم يعد رمز التجديد صالحا. وعند التصحيح، سجّل وجود الترويسة وطول قيمتها بدل تسجيل الرمز نفسه، فقد نبهت TikTok إلى أن من يملك الرمز يستطيع استخدامه.
الأخطاء الشائعة
- اعتبار 40104 رمزا منتهي الصلاحية. الرمز غائب لا قديم، لذا لن يغيّر تجديده شيئا ما لم يرسله الكود فعلا.
- تجديد الرمز دون تمرير الجديد. يعيد التجديد رمز وصول جديدا، ويجب أن ترسل الاستدعاءات اللاحقة هذه القيمة في Access-Token.
- إعادة الطلب دون تغيير. بدون الترويسة، تصل كل محاولة إلى TikTok بالطريقة نفسها وتحصل على الخطأ نفسه.
وإن أجابت TikTok بـ 40102 أو 40104 أو 40105 رغم ذلك، يُعلَّم الاتصال للإعادة فورا ويصلك بريد إلكتروني. من US$ 9 إلى US$ 0.75 لكل اتصال شهريا، ينخفض مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يمكن إرسال رمز وصول TikTok كـ Authorization: Bearer؟
لا. تقرأ نقاط نهاية Accounts API الرمز من الترويسة Access-Token، لذا يترك الرمز المُرسل كـ Authorization: Bearer الترويسة فارغة، فيعيد الاستدعاء الخطأ 40104، رغم أن TikTok تعطي نوع الرمز Bearer.
هل 40104 هو نفسه الرمز المنتهي الصلاحية؟
لا. تعني 40104 أن رمزا لم يصل أصلا، أما الرمز المنتهي فيعيد 40102، والرمز غير الصالح أو الخاطئ يعيد 40105.
هل تحتاج نقاط نهاية رمز TikTok إلى Access-Token؟
لا. تحدد /tt_user/oauth2/token/ و/tt_user/oauth2/refresh_token/ التطبيق بواسطة client_id و client_secret في جسم الطلب بدلا من ذلك.
هل يحل business_id محل الرمز؟
لا. يحدد business_id حساب TikTok المقصود بالاستدعاء، بينما تحمل Access-Token التفويض للتصرف نيابة عنه. يحتاج كل استدعاء إلى الاثنين معا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في