٤٠١ غير مصرح به: كيفية الإصلاح
يعني خطأ 401 أن الخادم لا يعرف هويتك. وهو يختلف عن خطأ 403؛ حيث يعني خطأ 403 أن هويتك معروفة ولكنك تفتقر إلى الصلاحية، بينما يعني خطأ 401 فشل عملية المصادقة (authentication).
الخبر السار هو أنه يمكنك إصلاح ذلك، فعادةً ما يكون السبب خطأً في الإعدادات (configuration error).
الأسباب الشائعة لأخطاء 401:
- أخطاء مطبعية في مفتاح API الخاص بك. مسافة واحدة في نهاية المفتاح قد تؤدي إلى تعطل عمله. احرص دائماً على إزالة المسافات الزائدة (trim) من مفاتيحك.
- انتهاء صلاحية المفاتيح. غالباً ما تتوقف الخدمات عن العمل دون سابق إنذار. تحقق من تواريخ انتهاء الصلاحية.
- أخطاء في متغيرات البيئة (environment variables). قد لا يزال الكود الخاص بك يستخدم إعدادات قديمة، وهذا يحدث كثيراً في حاويات Docker.
- تنسيقات ترويسة (header) خاطئة. تتطلب بعض واجهات برمجة التطبيقات (APIs) بادئة Bearer، بينما تستخدم أخرى ترويسات مخصصة مثل X-API-Key.
- مشكلات البروكسي (Proxy). قد تقوم البوابة (gateway) بحظرك قبل أن تصل حتى إلى الـ API.
استخدم قائمة التحقق هذه لاستكشاف الأخطاء وإصلاحها:
• قم بطباعة المفتاح الذي ترسله للتأكد من مطابقته للسجلات لديك.
• تحقق من أن المفتاح لا يزال نشطاً.
• تحقق من تنسيق الترويسة (header) الخاص بك بمقارنته بالوثائق التقنية (documentation).
• اختبر المفتاح باستخدام أمر curl في واجهة السطر البرمجي (terminal).
• تحقق مما إذا كان البروكسي يقوم بتغيير الترويسات الخاصة بك.
توقف عن محاولة استخدام منطق إعادة المحاولة (retry logic). إعادة المحاولة عند حدوث خطأ 401 لن تفيد؛ يجب عليك إصلاح بيانات الاعتماد (credentials) أولاً.
المصدر: https://dev.to/laowuuu_dev/401-unauthorized-the-api-error-thats-easier-to-fix-than-you-think-3o4h