الانتقال إلى المحتوى الرئيسي

رموز حالة HTTP

مغلفات الاستجابة

نجاح

سوق غير مدعوم

يُعاد عندما لا يوجد مسار قابل للتنفيذ للرمز على أي تبادل لامركزي مدعوم. يوفر حقل message شرحاً مقروئاً.

لم يُفهرس

يُعاد عندما يوجد الرمز لكن لم يتم حله بعد. أعد المحاولة بعد تأخير قصير.

خطأ

استجابات أخطاء عامة لإخفاقات التحقق وحدود المعدل وأخطاء الخادم.
تحلل حزم التطوير جميع متغيرات الاستجابة وتكشفها عبر نوع ExitApiError.

أنواع ExitApiError

تكشف كل حزمة تطوير ExitApiError (أو ما يعادله) بمميز kind:

التحقق من قابلية إعادة المحاولة

سلوك إعادة المحاولة المدمج

تتضمن جميع حزم التطوير إعادة محاولة تلقائية بهذه الافتراضيات: تنطلق إعادة المحاولة فقط للأخطاء حيث يُعيد isRetryable() القيمة true (إخفاقات النقل واستجابات 5xx و429 لحدود المعدل).

تخصيص سياسة إعادة المحاولة

أفضل الممارسات

  • لا تعد المحاولة لأخطاء 400 أو 401 أو 422. هذه تشير إلى مشكلة في الطلب أو المصادقة يجب إصلاحها في الكود.
  • لا تعد المحاولة لـ 404 مع "status": "unsupported". الرمز ليس لديه سوق مدعوم.
  • أعد المحاولة مرة لـ 404 مع "status": "not_indexed". قد يحتاج الرمز لحظة للحل.
  • تراجع أسياً عند استجابات 429. تتعامل إعادة المحاولة المدمجة مع هذا تلقائياً.
  • أعد المحاولة مع تراجع عند أخطاء 502 و503. هذه مشاكل بنية تحتية عابرة.
  • سجّل تفاصيل الأخطاء بما في ذلك kind وstatus وbody للتصحيح.
  • إذا رأيت أخطاء envelope_status متكررة، تحقق من صحة عنوان mint وuser_pubkey.