واجهة البرمجة العامة

تشخيص 401 و403 و422 و429

401 يعني أن المفتاح لم يُقبل أصلًا. و403 يعني أن المفتاح قُبل لكن العملية غير مسموح بها. و422 يعني أن الطلب فُهم وأن الحمولة خاطئة. و429 يعني أنك تجاوزت حدّ المعدّل والأولى أن تنتظر بدل إعادة المحاولة فورًا.

روجعت في 20 أغسطس 2026

الخطوات

1. عند 401 تحقق أن المفتاح موجود وغير منتهٍ ومُرسَل في الترويسة التي تظن — والسبب الشائع لصقٌ مبتور.
2. عند 403 اقرأ code: نطاق ناقص، أو عنوان خارج قائمة السماح، أو مفتاح يخص مساحة عمل أخرى. إعادة الاتصال لا تفيد؛ ما يجب أن يتغير هو الإذن.
3. عند 422 اقرأ الحقل الذي يسمّيه الرد وأصلح الحمولة.
4. عند 429 احترم ترويسات حدّ المعدّل وانتظر. إعادة الإرسال فورًا تزيد الأمر سوءًا.
5. احتفظ بـ requestId من الرد — فهو ما يمكّن الدعم من إيجاد نداءك بعينه.

كيف تتحقق من النتيجة

ينجح الطلب نفسه بعد الإصلاح، ويحمل الرد حالة 2xx مع الكائن المتوقَّع.

ما الذي يخطئ عادةً

• اعتبار 403 مفتاحًا فاسدًا وإعادة إصداره، وهذا لا يغيّر شيئًا.
• تكرار 429 في حلقة ضيقة.
• إرسال المفتاح إلى الدعم بدل معرّف الطلب.