الأخطاء

تستخدم الأخطاء صيغة RFC 7807 وهي application/problem+json، فتكون متسقة وقابلة للقراءة آليا:

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json

{
  "type": "https://docs.grem.capital/api/errors/validation",
  "title": "validation",
  "status": 400,
  "detail": "totalArea (m2) is required",
  "requestId": "req_…"
}

سجّل دائما قيمة requestId - واذكرها في طلبات الدعم لتتبع الاستدعاء.

رموز الحالة

التعامل مع الأخطاء

• تفرّع بحسب قيمة status الرقمية في HTTP لا بحسب نص detail المقروء.
• أعد محاولة 429 و5xx بتراجع أسي؛ ولا تعد محاولة 4xx (عدا 409 بعد انتهاء الطلب الجاري).
• ولا تتسرب تفاصيل المزودين في الأخطاء أبدا - إذ يظهر العطل بوصفه provider_error عاما.