رموز الأخطاء
كل نوع خطأ تعيده هذه الواجهة، مع حالة HTTP الخاصة به.
الحقل type هو الحقل الثابت القابل للقراءة برمجياً الذي تبني عليه منطقك. الحقل code يزيد الدقة لكل نقطة نهاية (انظر جدول الأخطاء الخاص بكل نقطة نهاية) — كلاهما آمن للتحليل البرمجي؛ أما message فلا.
| الحالة | type |
|---|---|
| 400 | invalid_requestنص الطلب أو الاستعلام فشل في التحقق. |
| 401 | unauthorizedرمز Bearer مفقود أو غير صحيح. |
| 403 | forbiddenالرمز صحيح لكنه لا يملك الصلاحية المطلوبة. |
| 404 | not_foundالمورد غير موجود أو لا يخص هذا المستخدم. |
| 409 | conflictالطلب يتعارض مع الحالة الحالية للمورد. |
| 422 | insufficient_balanceرصيد المحفظة منخفض جداً لتنفيذ هذه العملية. |
| 429 | rate_limitedطلبات كثيرة جداً — راجع حدود الطلبات. |
| 500 | internal_errorخطأ غير متوقع في الخادم — آمن لإعادة المحاولة. |