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

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

هذه صفحة واحدة من توثيق Antiro (https://docs.antiro.io/ar/api/errors). كل الصفحات في ملف واحد: https://docs.antiro.io/ar/llms-full.txt

## صيغة الخطأ

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

**401 Unauthorized**

```json
{
  "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 الجواب. | اقبل الطلب وأعد فحصه لاحقاً. |

لا تخسر طلباً بسبب خطأ: انظر [إذا لم يصل جواب](https://docs.antiro.io/ar/api/decisions#%D8%A5%D8%B0%D8%A7-%D9%84%D9%85-%D9%8A%D8%B5%D9%84-%D8%AC%D9%88%D8%A7%D8%A8).

## حدود الطلبات

| الطلب | الحد |
| --- | --- |
| `POST /v1/assessments` | 600 في الدقيقة لكل متجر |
| `POST /v1/outcomes` | 6,000 في الدقيقة لكل مفتاح |
| `GET /v1/assessments/:id` | 600 في الدقيقة لكل مفتاح |

وقد يظهر `429` أيضاً إذا جرت فحوص كثيرة في اللحظة نفسها، وهو مؤقت دائماً. إن احتجت إلى حد أعلى، [راسلنا](mailto:support@antiro.io).

## حدود الحقول

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

| الحقل | أقصى عدد من الأحرف |
| --- | --- |
| `session_token` | 1,024 |
| `order_id` | 128 |
| `phone` | 64 |
| `ip` | 64 |
| `name` | 500 |
| `address` | 3,000 |
| `wilaya`، `commune` | 300 |