رموز الأخطاء

لكل استجابات الأخطاء البنية نفسها. اعتمد على حالة HTTP وعلى error.code؛ أما error.message فنص إنجليزي مقروء وقد يتغيّر.

صيغة الخطأ

{
  "detail": "…",
  "error": {
    "code": "api.cursor_invalid",
    "message": "The cursor is malformed or was issued for different filters.",
    "details": {"parameter": "cursor"},
    "request_id": "01JB7Q2M4X9V3K8T5N6P0R1S2A",
    "doc_url": "https://developers.sursa.com/errors/api.cursor_invalid"
  }
}

الحقل error.code هو الرمز المذكور في هذه الصفحة؛ ويطابق error.request_id الترويسة X-Request-Id؛ ويشير error.doc_url إلى هذه الصفحة.