> ## 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.

# مساحات الأسماء والمفاتيح

> عزل مساحات الأسماء، وحالات دورة الحياة، ومفاتيح cdb_ محدَّدة النطاق بصلاحيات قراءة وكتابة وحذف، وحدود معدل لكل مفتاح، ونقاط بيانات وصفية.

## مساحات الأسماء

مساحة الأسماء مخزن كامل معزول — بـ WAL خاصة به وموصل استدامة ومرآة لتخزين الكائنات. الأسماء 1–96 حرفاً من `[a-z0-9_-]`، لا تبدأ بـ `-` أو `_`، وتقع دائماً تحت بادئة حسابك.

**دلالات دورة الحياة صريحة:**

| الحالة                               | السلوك                                                                                                                                                           |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| لم يُكتب فيها قط                     | تُعيد القراءات `404 namespace_not_found` — الكتابات فقط تُنشئ                                                                                                    |
| نشطة                                 | جميع العمليات ضمن نطاق مفتاحك                                                                                                                                    |
| مشغولة / لم تصبح مرآتها مُستدامة بعد | يُعيد الحذف `409` قابلاً لإعادة المحاولة                                                                                                                         |
| محذوفة                               | `410 namespace_deleted`، بشكل دائم — يُثبَّت شاهد قبر مُستدام محلياً **و** إلى المرآة قبل إزالة البيانات، لذا لا يمكن لاستعادة قديمة أن تعيد أبداً بيانات محذوفة |

```bash theme={null}
# افحص دون فتح المخزن
curl -s https://db.conare.ai/v1/namespaces/acme-docs/metadata \
  -H "Authorization: Bearer $CONAREDB_API_KEY"
# → { "name", "approx_row_count", "approx_logical_bytes", "generation", "dims", "index": {"status": "ann"} }

# حذف دائم (يتطلب صلاحية الحذف)
curl -s -X DELETE https://db.conare.ai/v1/namespaces/acme-docs \
  -H "Authorization: Bearer $DELETE_KEY"
```

## المفاتيح

تُزوَّد رموز `cdb_...` من [وحدة التحكم](https://db.conare.ai). لكل مفتاح:

* **نطاق مساحة الأسماء** — أسماء دقيقة أو بادئات مذيّلة بـ `*`. يمكن للمفتاح فقط الوصول إلى `/v1/namespaces/{name}/*` حيث يتطابق الاسم مع أنماطه؛ كل ما عداه يُنتج `403`.
* **صلاحيات مستقلة** — `read` و`write` والحذف المُدمِّر `delete` منح منفصلة. الحذف المادي لمساحة الأسماء يتطلب دائماً `delete` صريح.
* **حد المعدل** — دلو رموز طلبات في الثانية لكل مفتاح مع فيض ثانية واحدة؛ الطلبات فوق الحد تحصل على `429 rate_limited`.
* **انتهاء الصلاحية** — تُعيد المفاتيح المنتهية `401 expired_key`.

تُعرض الأسرار مرة واحدة وتُخزَّن فقط كملخصات SHA-256؛ المقارنة أثناء التشغيل بزمن ثابت.

<Warning>
  لا تمنح `delete` لمفتاح استيعاب يومي. استخدم بيانات اعتماد منفصلة قصيرة العمر للعمليات المُدمِّرة، وافصل التقديم (مفتاح للقراءة فقط) عن أنابيب إعادة البناء (مفتاح للكتابة).
</Warning>

## المراقبة

| نقطة النهاية                      | المصادقة          | الغرض                                                                             |
| --------------------------------- | ----------------- | --------------------------------------------------------------------------------- |
| `GET /health`                     | لا شيء            | حيوية العملية                                                                     |
| `GET /ready`                      | لا شيء            | صالح للخدمة؛ `503` أثناء التصريف أو بعد فشل موصل الاستدامة — وجّه موازن الحمل هنا |
| `GET /v1/namespaces/{ns}/metrics` | مفتاح محدد النطاق | عدّادات وقت التشغيل لمساحة الأسماء لديك                                           |
| `GET /v1/console`                 | مفتاح محدد النطاق | بيانات وصفية مُخفَّاة للمفتاح، وأرقام الاستخدام والمقاييس لمساحات أسمائك فقط      |

الإتاحة العامة — التي تُفحص من خمس مناطق عالمية مقابل `https://db.conare.ai/ready` — تُنشر على [conare.betteruptime.com](https://conare.betteruptime.com/). سجلات ومقاييس واجهة API لا تتضمن أبداً محتوى الطلبات أو رموز Bearer.