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

# مجموعة Postman

> قم باستيراد مجموعة Postman الخاصة بواجهة Living Security Public API التي تم إنشاؤها، ثم الصق مفتاح API، واستدعِ /v1 خلال دقائق.

يتم إنشاء مجموعة Postman الخاصة بالإصدار v1 من واجهة Living Security API من مواصفات OpenAPI نفسها التي يقوم عليها [مرجع API v1](/v1-reference/openapi-v1.json)،
لذلك فهي تتطابق دائمًا مع العقد المنشور. وتغطي جميع عمليات `/v1`،
مجمّعة حسب المورد، مع إعداد المصادقة مسبقًا.

## التنزيل

<Info>
  ستطالبك روابط التنزيل بتسجيل الدخول باستخدام حسابك في Living Security
  قبل تقديم الملف.
</Info>

<CardGroup cols={1}>
  <Card title="مجموعة Living Security API v1" icon="download">
    مجموعة Postman Collection v2.1 تتضمن جميع عمليات `/v1` مع إعداد مصادقة Basic
    مسبقًا. قيمة `baseUrl` في المجموعة فارغة — حدد بيئة إقليمية
    قبل إرسال أي طلب.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">تنزيل المجموعة</a>
  </Card>

  <Card title="بيئة الإنتاج (الولايات المتحدة)" icon="download">
    `baseUrl` مضبوطة مسبقًا على `https://api.us-east-1.livingsecurity.ai/v1`، مع
    متغيرَي `apiKeySecret` و`contractVersion` الفارغين لتقوم بتعبئتهما.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">تنزيل بيئة الإنتاج للولايات المتحدة</a>
  </Card>

  <Card title="بيئة الإنتاج (الاتحاد الأوروبي)" icon="download">
    `baseUrl` مضبوطة مسبقًا على `https://api.eu-west-1.livingsecurity.ai/v1`، مع
    متغيرَي `apiKeySecret` و`contractVersion` الفارغين لتقوم بتعبئتهما.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">تنزيل بيئة الإنتاج للاتحاد الأوروبي</a>
  </Card>

  <Card title="قالب البيئة" icon="download">
    المتغيرات نفسها مع `baseUrl` فارغ، لإعدادات غير الإنتاج.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">تنزيل قالب البيئة</a>
  </Card>
</CardGroup>

## الإعداد في Postman

<Steps>
  <Step title="استيراد الملفات">
    في Postman، اختر **استيراد** ثم أسقط ملف المجموعة مع بيئة
    الإنتاج (الولايات المتحدة) أو الإنتاج (الاتحاد الأوروبي) التي تطابق
    المنظمة. راجع [المناطق](/ar/developers/v1/regions).
  </Step>

  <Step title="إنشاء مفتاح API">
    في لوحة التحكم، افتح **الإعدادات ← التكاملات والمطورون ←
    Developer Hub**، ثم أنشئ حساب خدمة وأنشئ مفتاح API. يبدأ سر المفتاح بـ `lsk_live_` ويُعرض
    مرة واحدة فقط — انسخه فورًا. راجع
    [مفاتيح API](/ar/developers/developer-hub/api-keys) للتفاصيل.
  </Step>

  <Step title="لصق السر">
    عيّن المتغير `apiKeySecret` — إما في البيئة المستوردة
    (موصى به؛ فهو متغير من نوع سري) أو في علامة التبويب
    **المتغيرات** الخاصة بالمجموعة.
  </Step>

  <Step title="إرسال طلب">
    حدد البيئة الإقليمية المستوردة، وافتح أي طلب — على سبيل المثال
    **المنظمة ← Retrieve the organization** — ثم انقر **إرسال**. لا
    ترسل أي طلب قبل تحديد بيئة؛ فقيمة `baseUrl` في المجموعة فارغة
    عن قصد.
  </Step>
</Steps>

## كيفية إعداد المصادقة مسبقًا

تضبط المجموعة مصادقة Basic على مستوى المجموعة باسم المستخدم `apikey`
وكلمة المرور `{{apiKeySecret}}`. تقبل واجهة API سر المفتاح في أي من حقلي
مصادقة Basic، لذلك يعمل هذا الإعداد كما هو بمجرد تعيين المتغير.

إذا كنت تفضّل مصادقة Bearer، فغيّر نوع **Authorization** في المجموعة
إلى **Bearer Token** واستخدم `{{apiKeySecret}}` كرمز — إذ تقبل واجهة API
السر نفسه بالطريقتين.

لا يتطلب استخدام ترويسة Bearer مع مفتاح API استخدام OAuth. لاستخدام OAuth،
عيّن **Bearer Token** إلى رمز وصول OAuth الخاص بك بدلًا من سر مفتاح API.
راجع [المصادقة](/ar/developers/v1/authentication) لاختيار الطريقة، و
[بيانات اعتماد عميل OAuth](/ar/developers/v1/oauth) لإعداد الرمز والعميل.

## ترويسة إصدار العقد

يحمل كل طلب ترويسة `Living-Security-Version` مضبوطة مسبقًا على
`{{contractVersion}}`، وهي معطّلة افتراضيًا. اتركها معطّلة لاستخدام إصدار العقد
المثبّت لمنظمتك. وفعّلها لتثبيت الطلب على إصدار منشور
محدد — راجع [سجل التغييرات](/ar/developers/v1/changelog)
للاطلاع على الإصدارات المنشورة.

## معلمات الاستعلام والأجسام

مرشحات نقاط النهاية التي تعرض قوائم (`limit` و`page_token` والمرشحات الخاصة بكل مورد)
مضمّنة في كل طلب لكنها معطّلة، بحيث ينجح استدعاء كل
نقطة نهاية بعد استيراد جديد. فعّل المرشحات التي تحتاج إليها واملأها — راجع
[ترقيم الصفحات](/ar/developers/v1/pagination) لمعرفة كيفية عمل `page_token`. أما أجسام
الطلبات في عمليات `POST` فتكون معبأة مسبقًا بقيم نائبة محددة الأنواع.

<Note>
  يُعاد إنشاء المجموعة من مواصفات OpenAPI المنشورة عند كل تغيير في
  العقد — نزّل نسخة جديدة بدلًا من تعديل الطلبات التي
  تريد إبقاءها محدّثة.
</Note>


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