كيف يجب أن أتعامل مع أخطاء واجهة برمجة التطبيقات (API)؟

يستخدم API v2 رموز حالة HTTP القياسية ويعيد كل خطأ كاستجابة JSON من نوع problem-details تتضمن نوعًا ورسالة وصفية. الرمز 200 يعني النجاح، و400 يعني أن الطلب غير صالح (مثل مفتاح API مفقود أو غير صالح، أو معامل غير صالح، أو عدد كبير جدًا من الأسماء في استدعاء واحد)، و401 مع النوع «limit-exceeded» يعني أنه لم تتبقَّ طلبات في حسابك، و404 يعني أن نقطة النهاية غير موجودة. يعيد API v1 الحقلين errno وerrmsg في استجابة JSON؛ والرمز errno 30 يعني أنك بلغت حد الطلبات. إذا نفدت طلباتك، فاشترِ باقة جديدة أو انتظر إعادة الشحن الشهرية – فإعادة المحاولة لن تفيد. للأخطاء المستمرة، راجع وثائق API أو تواصل مع الدعم.