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

# مقدمة

> عنوان الأساس والمصادقة والاصطلاحات المشتركة بين كل نقاط النهاية.

<Note>
  صفحات نقاط النهاية في قسم مرجع API هذا (مخططات الطلب والرد وساحة التجربة) تُولَّد من مخطط OpenAPI ومتاحة بالإنجليزية فقط. الأدلة بهذه اللغة تغطي السلوك نفسه.
</Note>

## عنوان الأساس

كل نقاط النهاية تقع تحت `https://api.chattler.ai/v1`. لا يُخدَم إلا HTTPS.

## المصادقة

كل طلب يحتاج إلى مفتاح API في الترويسة `Authorization` بنظام `Bearer`. يُنشأ المفتاح في تطبيق Chattler؛ راجع [احصل على مفتاح API](/ar/get-started/api-key).

```http theme={null}
Authorization: Bearer cht_live_<key_id>.<secret>
```

المفاتيح مرتبطة بوكيل واحد وتحمل صلاحية: `read-only` لنقطتي نهاية `GET`، و`full` لهما بالإضافة إلى نقطتي نهاية الدردشة `POST`.

## الاصطلاحات

* أجسام الطلب والرد بصيغة JSON (`Content-Type: application/json`)، باستثناء نقطة نهاية الرد المتدفق التي تجيب بـ `text/event-stream`.
* نقطتا نهاية الدردشة كلتاهما تتطلبان ترويسة `Idempotency-Key`، من 1-255 حرفًا، فريدة لكل طلب منطقي. راجع [التكرار الآمن](/ar/guides/idempotency).
* كل رد يحمل `X-Request-ID`. ترويسات حد المعدل `X-RateLimit-Limit` و`X-RateLimit-Remaining` و`X-RateLimit-Reset` موجودة في ردود JSON `200` وفي `429`؛ أما تدفق SSE وردود الأخطاء الأخرى فلا تحملها. راجع [حدود المعدل](/ar/guides/rate-limits).
* كل إخفاق هو `{"error": {"code", "message", "request_id"}}`. راجع [الأخطاء](/ar/guides/errors).
* القوائم هي `{"data": [...], "next_cursor": "..." | null}`؛ `limit` من 1-100، والافتراضي 20.
* الطوابع الزمنية بصيغة ISO-8601 بتوقيت UTC. تقبل المرشّحات قيمًا بمنطقة زمنية أو من دونها (القيمة بلا منطقة زمنية تُقرأ على أنها UTC)؛ `date_to` غير شامل.

## جرّبها في ساحة التجربة

لصفحات نقاط النهاية ساحة تجربة. الصق مفتاحًا حقيقيًا كرمز bearer واستخدم معرّف الوكيل الذي ينتمي إليه المفتاح؛ تذهب الطلبات مباشرة إلى `https://api.chattler.ai` وتُفوتر كأي استدعاء آخر.

<Warning>
  لا تلصق مفتاح `full` في شاشة مشتركة أو تسجيل. دوّره في التطبيق إن فعلت.
</Warning>