> ## 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 שנוצר עבור ה-API הציבורי של Living Security, הדביקו מפתח API והתחילו לקרוא ל-/v1 בתוך דקות.

אוסף Postman של Living Security API v1 נוצר מאותה מפרט 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="סביבת Production (US)" 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">הורדת סביבת הייצור של US</a>
  </Card>

  <Card title="סביבת Production (EU)" 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">הורדת סביבת הייצור של EU</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, בחרו **Import** וגררו פנימה את קובץ האוסף יחד עם סביבת
    Production (US) או Production (EU) התואמת
    לארגון. ראו [אזורים](/he/developers/v1/regions).
  </Step>

  <Step title="יצירת מפתח API">
    בלוח המחוונים, פתחו **הגדרות → Integrations & Developers →
    Developer Hub**, צרו חשבון שירות וצרו מפתח API. סוד המפתח מתחיל ב-`lsk_live_` ו
    מוצג פעם אחת בלבד — העתיקו אותו מיד. לפרטים נוספים ראו
    [מפתחות API](/he/developers/developer-hub/api-keys).
  </Step>

  <Step title="הדבקת הסוד">
    הגדירו את המשתנה `apiKeySecret` — בסביבה שיובאה
    (מומלץ; זהו משתנה מסוג סוד) או בלשונית
    **Variables** של האוסף.
  </Step>

  <Step title="שליחת בקשה">
    בחרו את הסביבה האזורית שיובאה, פתחו כל בקשה — לדוגמה
    **Organization → Retrieve the organization** — ולחצו **Send**. אין
    לשלוח בקשה לפני שנבחרה סביבה; `baseUrl` של האוסף ריק
    במכוון.
  </Step>
</Steps>

## כיצד האימות מוגדר מראש

האוסף מגדיר אימות Basic ברמת האוסף עם שם משתמש `apikey`
וסיסמה `{{apiKeySecret}}`. ה-API מקבל את סוד המפתח בכל אחד משדות
אימות Basic, ולכן הדבר פועל כמות שהוא לאחר הגדרת המשתנה.

אם ברצונכם להשתמש באימות Bearer, שנו את סוג **Authorization** של האוסף
ל-**Bearer Token** והשתמשו ב-`{{apiKeySecret}}` כאסימון — ה-API
מקבל את אותו סוד בשני האופנים.

שימוש בכותרת Bearer עם מפתח API אינו דורש OAuth. כדי להשתמש ב-OAuth,
הגדירו את **Bearer Token** כאסימון הגישה של OAuth במקום סוד מפתח ה-API.
ראו [אימות](/he/developers/v1/authentication) לבחירת שיטה ו-
[OAuth client credentials](/he/developers/v1/oauth) להגדרת האסימון והלקוח.

## כותרת גרסת החוזה

כל בקשה כוללת כותרת `Living-Security-Version` המוגדרת מראש ל-
`{{contractVersion}}`, והיא מושבתת כברירת מחדל. השאירו אותה מושבתת כדי להשתמש בגרסת החוזה
הנעוצה של הארגון שלכם. הפעילו אותה כדי לנעוץ את הבקשה
לגרסה שפורסמה ספציפית — לגרסאות שפורסמו ראו את [יומן השינויים](/he/developers/v1/changelog).

## פרמטרי שאילתה וגופי בקשות

מסנני נקודות הקצה מסוג רשימה (`limit`, `page_token` ומסננים ייעודיים למשאב)
כלולים בכל בקשה אך מושבתים, כך שייבוא חדש קורא לכל
נקודת קצה בהצלחה. הפעילו ומלאו את אלה שדרושים לכם — ראו
[עימוד](/he/developers/v1/pagination) להסבר כיצד `page_token` פועל. גופי
הבקשות בפעולות `POST` ממולאים מראש בערכי מציין מיקום מטיפוסים מתאימים.

<Note>
  האוסף נוצר מחדש מפרט OpenAPI שפורסם בכל שינוי
  בחוזה — הורידו עותק עדכני במקום לערוך בקשות
  שברצונכם לשמור עדכניות.
</Note>


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