الأخطاء والحدود

ما تعيده الواجهة عند فشل الطلب، وكم تقبل من الطلبات.

صيغة الخطأ#

لكل الأخطاء الجسم نفسه، وmessage قائمة دائماً.

401 Unauthorized

{
  "success": false,
  "statusCode": 401,
  "message": ["Invalid API key"],
  "errors": null,
  "timestamp": "2026-10-30T10:03:06.493Z"
}

الرمز	المعنى	ما تفعله
`400`	حقل بنوع خاطئ، أو `id` غير صالح، أو إبلاغ بلا `verdict` ولا `outcome`.	صحّح الطلب.
`401`	المفتاح السري مفقود أو غير صحيح.	راجع `X-API-Key`.
`404`	لا يعرف Antiro هذا الطلب أو الفحص، أو إبلاغ بلا `order_id` ولا `assessment_id`.	راجع المعرّف.
`429`	طلبات كثيرة.	اقبل الطلب وأعد فحصه بعد قليل.
`5xx`	تعذّر على Antiro الجواب.	اقبل الطلب وأعد فحصه لاحقاً.

لا تخسر طلباً بسبب خطأ: انظر إذا لم يصل جواب.

وقد يظهر 429 أيضاً إذا جرت فحوص كثيرة في اللحظة نفسها، وهو مؤقت دائماً. إن احتجت إلى حد أعلى، راسلنا.

النص الأطول من حده يُقصّ إلى ذلك الحد، ولا يُرفض.