التشغيل الفعلي
الأخطاء
صيغة خطأ واحدة، وحالات HTTP واضحة، ومتى تكون إعادة المحاولة آمنة.
3 دقائق قراءة
في هذه الصفحة
صيغة الخطأ
{ "status": "error", "message": "amount must be positive", "code": null }الحقل message مكتوب للبشر ويمكن عرضه على موظفيك. وتحمل أخطاء الخادم أيضًا code: "internal_error" ومرجعًا: اذكره للدعم وسنجد الطلب المحدد.
حالات HTTP
| الحالة | المعنى | إعادة المحاولة؟ |
|---|---|---|
| 400 | خطأ في التحقق: حقل مفقود أو غير صالح. | لا. أصلح الطلب. |
| 401 | رمز أو مفتاح مفقود أو غير صالح أو منتهي الصلاحية. | بعد الحصول على رمز جديد. |
| 404 | الخصم أو المعاملة أو المورد غير موجود لتطبيقك. | لا. |
| 429 | حد المعدل: طلبات أو محاولات كثيرة جدًا. | نعم، بعد الانتظار قليلًا. |
| 500 | حدث خطأ من جهتنا (مع مرجع). | نعم، بمفتاح idem نفسه. |
في أي حركة أموال، أعد المحاولة بمفتاح منع التكرار نفسه فقط. فهذا ما يجعل إعادة المحاولة آمنة.