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

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

> غلاف الأخطاء المستقر، وربط X-Request-Id، ومعاني رموز حالة HTTP، وترويسات حدود المعدل، وسلوك 402 عند نفاد الحصة المتاحة في اشتراكك.

## غلاف الأخطاء

يستخدم كل خطأ شكلاً مستقراً واحداً — ولا يُسرّب أبداً مُعرّفات المستأجرين الداخلية أو نصوص أخطاء الواجهة الخلفية:

```json theme={null}
{
  "statusCode": 409,
  "code": "stale_source_version",
  "message": "Version 6 is older than the applied version 7.",
  "requestId": "req_...",
  "details": { }
}
```

تفرّع الفروع على `code`، لا على `message` — يمكن إعادة صياغة الرسائل؛ الرموز مستقرة.

## مُعرّفات الطلبات

تحمل كل استجابة `X-Request-Id`. أرسل مُعرّفك الخاص (1–128 حرفاً؛ الحرف الأول أبجدي رقمي، ثم `A-Za-z0-9._:-`) لربط طلب واحد عبر حافة Conare ومستوى الذاكرة؛ وإلا يُولّده Conare. اقتبسه في أي طلب دعم.

## رموز الحالة

| الحالة | المعنى                                                         | ما يجب فعله                                                                        |
| ------ | -------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| `400`  | طلب غير صالح (مثل `model_not_served`، مُعرّف مجموعة غير معروف) | صحّح الطلب — الرسالة تحدد الخطأ بدقة                                               |
| `401`  | مفتاح مفقود أو غير صالح                                        | تحقق من رمز Bearer                                                                 |
| `402`  | استُنفدت حصة الاستخدام وميزانية التجاوز                        | تتضمن الاستجابة بيانات الرصيد وإعادة التعيين — اعرضها، ولا تُعد المحاولة بشكل أعمى |
| `403`  | المفتاح يفتقر إلى النطاق المطلوب                               | امنح النطاق على التكامل                                                            |
| `409`  | تعارض في الإصدار على دورة حياة المصدر                          | راجع [الذكريات المملوكة للمصدر](/memory/lifecycle) — عادةً يعني "دائم بالفعل"      |
| `413`  | المحتوى أكبر من المسموح                                        | قسّم الحمولة                                                                       |
| `429`  | تم تحديد المعدل                                                | تراجع وفقاً لترويسات حد المعدل                                                     |
| `503`  | الواجهة الخلفية غير جاهزة (مثل `integration_unbillable`)       | أعد المحاولة بتراجع تدريجي؛ تحقق من `/api/v1/status`                               |

## التخفيض بدلاً من الفشل

عند وجود بديل أرخص، يخفّض Conare بدلاً من رمي خطأ:

* **الاستدعاء العميق** على حصة قديمة مستنفدة يُعيد `{ answer: null, results: [...], deepUsed: false }` — تظل تحصل على ذكريات خام مُرتَّبة.
* **الاقتراحات** ليس لها بديل سطحي ذو معنى، لذا فإن الاستنفاد هو `402` صارم (خطط الحصص القديمة: `429`).
* **مخرجات نموذج مُشوَّهة** على الاقتراحات تُعيد `{ suggestions: [], raw: "<text>" }` — عامِل `raw` كنص بديل قابل للعرض.

## لا يُقاس أبداً

استيعاب الجلسة، و`save`، والبحث/الاستدعاء السطحي لا تُقاس أبداً في أي خطة. تنطلق تنبيهات الإنفاق عند 75/90/100% والإعداد الافتراضي هو توقف صارم — بلا تجاوزات مفاجئة.