# نقاط النهاية

> الجدول الكامل لنقاط نهاية LMSP 1.0 بطريقة كل منها ومسارها ومستوى إلزامها وغرضها، مع اصطلاحات المسارات والمصادقة ونقاط النهاية الاختيارية.

Source: https://madeforagent.com/ar/lmsp/1.0/endpoints/
Language: ar
Specification: LMSP 1.0 (draft)
Updated: 2026-11-08

## 4.1 جدول نقاط النهاية {#table}

**يجب** على الخدمة المتوافقة أن تنفّذ كل نقطة نهاية موسومة بأنها إلزامية. و**يجوز** لها أن تنفّذ الاختيارية، وتشير إليها عبر رايات القدرات في [وصف الخدمة](https://madeforagent.com/ar/lmsp/1.0/discovery.md#service-description) الخاص بها.

| الطريقة | المسار | الإلزام | الغرض |
| --- | --- | --- | --- |
| GET | `/.well-known/lmsp.json` | إلزامية | [اكتشاف الخدمة والقدرات](https://madeforagent.com/ar/lmsp/1.0/discovery.md#service-description) |
| GET | `/lmsp/v1/openapi.json` | إلزامية | مواصفة الواجهة المقروءة آليًا |
| GET | `/lmsp/v1/health` | إلزامية | [فحص الحياة والجاهزية](https://madeforagent.com/ar/lmsp/1.0/common-rules.md#health) |
| POST | `/lmsp/v1/pair` | إلزامية | [استبدال رمز الاقتران برمز Bearer](https://madeforagent.com/ar/lmsp/1.0/security.md#pairing) |
| GET | `/lmsp/v1/models` | إلزامية | [سرد النماذج المحلية](https://madeforagent.com/ar/lmsp/1.0/models.md#list) |
| GET | `/lmsp/v1/models/{model_id}` | إلزامية | [الحصول على نموذج واحد](https://madeforagent.com/ar/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/responses` | إلزامية | [توليد متزامن أو مبثوث](https://madeforagent.com/ar/lmsp/1.0/responses.md#request) |
| GET | `/lmsp/v1/responses/{response_id}` | اختيارية | [استرجاع استجابة مخزَّنة](https://madeforagent.com/ar/lmsp/1.0/responses.md#sync) |
| POST | `/lmsp/v1/tasks` | إلزامية | [إنشاء مهمة توليد غير متزامنة](https://madeforagent.com/ar/lmsp/1.0/tasks.md#create) |
| GET | `/lmsp/v1/tasks/{task_id}` | إلزامية | [الحصول على مهمة غير متزامنة](https://madeforagent.com/ar/lmsp/1.0/tasks.md#create) |
| POST | `/lmsp/v1/tasks/{task_id}/cancel` | إلزامية | [إلغاء مهمة غير متزامنة](https://madeforagent.com/ar/lmsp/1.0/tasks.md#cancel) |
| GET | `/lmsp/v1/tasks/{task_id}/events` | اختيارية | [الاشتراك في تدفق الأحداث أو استئنافه](https://madeforagent.com/ar/lmsp/1.0/tasks.md#events) |
| POST | `/lmsp/v1/models/{model_id}/load` | اختيارية | [تحميل نموذج مسبقًا](https://madeforagent.com/ar/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/models/{model_id}/unload` | اختيارية | [إلغاء تحميل نموذج](https://madeforagent.com/ar/lmsp/1.0/models.md#operations) |

نقاط النهاية المتوافقة مع OpenAI تحت `/v1` ونقاط النهاية الاختيارية المتوافقة مع Ollama مدرجة في [الصفحة 8](https://madeforagent.com/ar/lmsp/1.0/compatibility.md).

## 4.2 الاصطلاحات {#conventions}

- **المتون.** متون الطلبات والاستجابات بصيغة JSON (`application/json`)، باستثناء تدفقات الأحداث (`text/event-stream`) والأخطاء (`application/problem+json`).
- **معاملات المسار.** الاسم بين قوسين معقوفين، مثل `{model_id}`، عنصر نائب. و**يجب** أن تُرمَّز القيم بترميز النسبة المئوية. ويُرسَل معرّف نموذج مثل `qwen3:14b-q4_k_m` على هيئة `qwen3%3A14b-q4_k_m`.
- **المصادقة.** تتطلب كل نقطة نهاية `Authorization: Bearer <token>`، باستثناء `/.well-known/lmsp.json` و`/lmsp/v1/openapi.json` و`/lmsp/v1/health` و`/lmsp/v1/pair`.
- **نقاط النهاية الاختيارية.** **يجب** أن ترد نقطة النهاية الاختيارية التي لا تنفذها الخدمة بـ `501 Not Implemented` مع رمز الخطأ `unsupported_capability`.
- **الإصدارات والأخطاء.** قد تحمل الطلبات ترويسات إصدار، ويستخدم كل خطأ صيغة واحدة. وكلاهما معرَّف في [الصفحة 9](https://madeforagent.com/ar/lmsp/1.0/common-rules.md).
- **العقد.** وثيقة OpenAPI المنشورة في [`/lmsp/1.0/openapi.json`](https://madeforagent.com/lmsp/1.0/openapi.json) هي الصورة المقروءة آليًا لهذه الصفحة. والنص هو المعياري حيث يختلف الاثنان.