الأخطاء وسلوك إعادة المحاولة

تستخدم الاستجابات غير الناجحة هذا الغلاف:

{
  "error": {
    "code": "SOME_CODE",
    "message": "Human-readable explanation",
    "issues": []
  }
}

إرشادات إعادة المحاولة

أعد المحاولة عند فشل النقل.
أعد محاولة عمليات الكتابة عديمة الأثر (idempotent) باستخدام نفس Idempotency-Key.
أعد قراءة الحالة الدائمة بعد العمل غير المتزامن بدلًا من افتراض أن الاستجابة الأولى مكتملة.

اعتبر حالات الفشل من جهة الخادم مرشحة لإعادة المحاولة فقط عندما كانت عملية الكتابة الأصلية تستخدم مفتاح عدم تكرار ثابتًا.
اعتبر عناوين URL الجديدة لتنزيل التصدير مؤقتة، وأعد قراءتها من GET /exports/{exportId} عند الحاجة.
إذا كانت عملية التعديل قيد التنفيذ بالفعل أو تتعارض مع الحالة الحالية، افحص code المُعاد وأعد المحاولة فقط عندما تظل العملية آمنة منطقيًا.

تقوم حزمة Node.js SDK وواجهة CLI المرفقتان بتطبيع الأخطاء إلى كائنات مُهيكلة تحتوي على:

وهذا يجعل من الآمن تفريع منطق الأتمتة دون تحليل سلاسل نصية حرة.