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

# سجل تغييرات واجهة برمجة التطبيقات (API)

> إصدارات العقد والتغييرات التي طرأت على واجهة برمجة التطبيقات العامة (Public API) الخاصة بـ Living Security.

تستخدم واجهة برمجة التطبيقات العامة (Public API) الخاصة بـ Living Security إصدارات عقد قائمة على التاريخ
(`YYYY-MM-DD`). وتضمّن وثيقة OpenAPI المنشورة إصدار العقد الخاص بها في
`info["x-contract-version"]`، وتحدد كل عملية مرحلة دورة حياتها في
`x-lifecycle-stage` (`preview` أو `compatibility` أو `ga`).

* تتوفر المواصفات الحالية دائمًا على
  [`/v1-reference/openapi-v1.json`](/v1-reference/openapi-v1.json).
* تتوفر لقطات المرجع الخاصة بكل إصدار على
  `/v1-reference/openapi/<version>.json`، على سبيل المثال
  [`/v1-reference/openapi/2026-07-01.json`](/v1-reference/openapi/2026-07-01.json).

تُطرح التغييرات الإضافية المتوافقة مع الإصدارات السابقة (عمليات جديدة وحقول اختيارية جديدة)
ضمن إصدار العقد الحالي. ولا يُنشر إصدار عقد جديد
إلا عند وجود تغييرات جذرية، مصحوبًا بإدخال في هذه الصفحة يصف
التغيير ومسار الترحيل.

## تحديثات التوثيق

**2026-08-25** — تذكر أدلة `/v1` وقائمة `servers` في OpenAPI الآن
المضيفين الإقليميين الفعليين في الولايات المتحدة والاتحاد الأوروبي. وهذا توضيح في التوثيق فقط. ولم يتغير إصدار
العقد. راجع [المناطق](/ar/developers/v1/regions).

## 2026-07-01

تدعم واجهة `/v1` Public API هذا الإصدار من العقد. يمكنك تثبيته باستخدام
`Living-Security-Version: 2026-07-01`، أو استخدام الإصدار الافتراضي المعيَّن
لحساب الخدمة الخاص بك.

راجع [البدء السريع لواجهة API](/ar/developers/v1/quickstart) لإرسال أول طلب،
و[المصادقة](/ar/developers/v1/authentication) لمفاتيح API وOAuth، و[المناطق](/ar/developers/v1/regions) لمعرفة المضيف الصحيح.

## 2026-08-05

يحدد هذا التاريخ عقد التوافق القديم المنفصل `/api/v1`.
وهو ليس قيمة `Living-Security-Version` لواجهة `/v1` API الجديدة.

* **الأشخاص**: البحث عن الأشخاص في المؤسسة (`GET /people/search`) واسترجاع
  عضوية شخص (`GET /people/{personId}/membership`).
* **مفاتيح الوصول إلى API**: إنشاء مفاتيح الوصول إلى API وعرضها وتدويرها وإلغاؤها
  (`POST /access-keys` و`GET /access-keys` و`POST /access-keys/{id}/rotate` و
  `DELETE /access-keys/{id}`).

جميع العمليات في هذا الإصدار منشورة في مرحلة دورة الحياة `compatibility`. راجع [نظرة عامة على Public API](/ar/developers/public-api/overview) للاطلاع على
المصادقة وتقسيم النتائج إلى صفحات ومعالجة الأخطاء، و
[سياسة التوافق وإيقاف الدعم](/ar/developers/public-api/overview#%D8%A7%D9%84%D8%AA%D9%88%D8%A7%D9%81%D9%82-%D9%88%D8%A5%D9%8A%D9%82%D8%A7%D9%81-%D8%A7%D9%84%D8%AF%D8%B9%D9%85)
لمعرفة كيفية تطور هذا العقد.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.