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

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

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

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

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

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

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

يُسهّل ذلك تفريع منطق الأتمتة بأمان دون تحليل سلاسل نصية حرة.