> ## Documentation Index
> Fetch the complete documentation index at: https://developers.nateq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# الأخطاء

> غلاف الأخطاء ورموز الأخطاء الشائعة.

تستخدم الأخطاء رموز حالة HTTP القياسية وغلاف JSON متّسق:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "API key does not have the required scope",
    "details": { "required_scope": "tickets:write" }
  }
}
```

تفرّع دائماً بناءً على `error.code` القابل للقراءة آلياً، وليس على `message` البشري.

## الرموز الشائعة

| الحالة | الرمز                   | المعنى                                                          |
| ------ | ----------------------- | --------------------------------------------------------------- |
| 401    | `MISSING_AUTHORIZATION` | لم يتم تقديم أي بيانات اعتماد                                   |
| 401    | `INVALID_API_KEY`       | المفتاح غير صالح أو ملغى أو منتهي الصلاحية                      |
| 403    | `INSUFFICIENT_SCOPE`    | يفتقر المفتاح إلى النطاق الذي تتطلبه نقطة النهاية               |
| 403    | `ENDPOINT_NOT_PUBLIC`   | نقطة النهاية غير متاحة لمفاتيح API (لوحة التحكم فقط)            |
| 403    | `IP_NOT_ALLOWED`        | استُخدم المفتاح من عنوان IP ليس في قائمة السماح                 |
| 404    | `NOT_FOUND`             | المورد غير موجود في مؤسستك                                      |
| 422    | `VALIDATION_ERROR`      | فشل التحقق من جسم الطلب                                         |
| 429    | `RATE_LIMIT_EXCEEDED`   | عدد كبير جداً من الطلبات — راجع [حدود المعدّل](/ar/rate-limits) |
| 500    | `INTERNAL_ERROR`        | حدث خطأ في جانبنا                                               |