العربيةالبداية
الأخطاء
عالج الأخطاء حسب حالة HTTP، ولا تُعِد كل طلب فاشل بشكل أعمى. أرسل دائمًا Accept: application/json.
الحالةما العمل
400معامل غير صالح أو تجاوز لحد حجم الصفحة. صحّح الطلب، ولا تُعِد إرساله دون تغيير.
401 / 403المفتاح مفقود أو غير صالح أو منتهي الصلاحية أو غير نشط، أو تم رفض الوصول إلى المصدر. تحقّق من الاستجابة والاشتراك، ولا تُعِد المحاولة دون تغيير.
404لم يتم العثور على المركبة أو اللوت. اعرض نتيجة فارغة، ولا تختلق سعراً.
429تم بلوغ حد الطلبات. التزم بـ Retry-After عند توفره، واستخدم تأخيراً متزايداً محدوداً، وراعِ حصة باقتك.
5xx / timeoutأعد المحاولة لعمليات القراءة الآمنة فقط، وبعدد محدود من المحاولات. احتفظ بآخر نقطة تحقق ناجحة، وتجنّب تسجيل المفاتيح أو الاستجابات الكاملة.
أخطاء المصادقة
- 403
{ "error": "please add auth key in x-api-key header" } - 403
{ "error": "wrong api key" } - 403
{ "error": "your api subscription has expired" } - 403
{ "error": "your api subscription is not active" }
اقرأ الاستجابة بأمان
- تُعيد فحوصات التطبيق عادةً كائنًا فيه error؛ أما أعطال إطار العمل والبوابة فتستخدم message.
- قد تُعيد البوابة أو الوكيل أو خادم الويب HTML أو نصًا عاديًا أو جسمًا فارغًا حتى عند طلب JSON.
- أعِد فقط طلبات GET الآمنة، بعدد محدود من المحاولات وفواصل متزايدة. احتفظ بآخر نقطة نجاح لديك.