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

> जनरेट किए गए Living Security Public API Postman collection को इम्पोर्ट करें, API key पेस्ट करें और कुछ ही मिनटों में /v1 को कॉल करें।

Living Security API v1 Postman collection उसी OpenAPI spec से जनरेट किया गया है जो [API v1 Reference](/v1-reference/openapi-v1.json) को संचालित करता है, इसलिए यह हमेशा प्रकाशित contract से मेल खाता है। यह सभी `/v1` operations को कवर करता है, जो resource के अनुसार समूहित हैं और जिनमें authentication पहले से कॉन्फ़िगर किया गया है।

## Download

<Info>
  फ़ाइल उपलब्ध कराए जाने से पहले डाउनलोड लिंक आपसे अपने Living Security खाते से साइन इन करने के लिए कहेंगे।
</Info>

<CardGroup cols={1}>
  <Card title="Living Security API v1 collection" icon="download">
    Postman Collection v2.1, जिसमें सभी `/v1` operations शामिल हैं और Basic auth पहले से कॉन्फ़िगर है। Collection `baseUrl` रिक्त है — अनुरोध भेजने से पहले कोई regional environment चुनें।

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Collection डाउनलोड करें</a>
  </Card>

  <Card title="Production (US) environment" icon="download">
    `baseUrl` को `https://api.us-east-1.livingsecurity.ai/v1` पर पहले से सेट किया गया है, और भरने के लिए `apiKeySecret` तथा `contractVersion` variables रिक्त हैं।

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">US production environment डाउनलोड करें</a>
  </Card>

  <Card title="Production (EU) environment" icon="download">
    `baseUrl` को `https://api.eu-west-1.livingsecurity.ai/v1` पर पहले से सेट किया गया है, और भरने के लिए `apiKeySecret` तथा `contractVersion` variables रिक्त हैं।

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">EU production environment डाउनलोड करें</a>
  </Card>

  <Card title="Environment template" icon="download">
    वही variables, जिनमें `baseUrl` रिक्त है, non-production सेटअप के लिए।

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Environment template डाउनलोड करें</a>
  </Card>
</CardGroup>

## Postman में सेट अप करें

<Steps>
  <Step title="फ़ाइलें इम्पोर्ट करें">
    Postman में **Import** चुनें और collection फ़ाइल के साथ वह Production (US) या Production (EU) environment डालें जो आपके संगठन से मेल खाता हो। [Regions](/hi/developers/v1/regions) देखें।
  </Step>

  <Step title="API key बनाएँ">
    Dashboard में **Settings → Integrations & Developers → Developer Hub** खोलें, एक service account बनाएँ और एक API key बनाएँ। Key secret `lsk_live_` से शुरू होता है और केवल एक बार दिखाया जाता है — इसे तुरंत कॉपी कर लें। विवरण के लिए [API keys](/hi/developers/developer-hub/api-keys) देखें।
  </Step>

  <Step title="Secret पेस्ट करें">
    `apiKeySecret` variable सेट करें — या तो इम्पोर्ट किए गए environment में (अनुशंसित; यह secret-type variable है) या collection के **Variables** टैब में।
  </Step>

  <Step title="अनुरोध भेजें">
    इम्पोर्ट किया गया regional environment चुनें, कोई भी अनुरोध खोलें — उदाहरण के लिए **Organization → Retrieve the organization** — और **Send** दबाएँ। Environment चुने जाने तक अनुरोध न भेजें; collection `baseUrl` जानबूझकर रिक्त रखा गया है।
  </Step>
</Steps>

## Authentication पहले से कैसे कॉन्फ़िगर किया गया है

Collection, collection स्तर पर Basic auth सेट करता है, जिसमें username `apikey` और password `{{apiKeySecret}}` है। API, key secret को किसी भी Basic auth फ़ील्ड में स्वीकार करता है, इसलिए variable सेट होते ही यह बिना किसी बदलाव के काम करता है।

यदि आप bearer authentication को प्राथमिकता देते हैं, तो collection के **Authorization** type को **Bearer Token** में बदलें और token के रूप में `{{apiKeySecret}}` का उपयोग करें — API दोनों तरीकों से उसी secret को स्वीकार करता है।

API key के साथ Bearer header का उपयोग करने के लिए OAuth आवश्यक नहीं है। OAuth का उपयोग करने के लिए, **Bearer Token** को API key secret के बजाय अपने OAuth access token पर सेट करें। कोई पद्धति चुनने के लिए [Authentication](/hi/developers/v1/authentication) और token तथा client सेटअप के लिए [OAuth client credentials](/hi/developers/v1/oauth) देखें।

## Contract version header

प्रत्येक अनुरोध में `Living-Security-Version` header होता है, जो `{{contractVersion}}` पर पहले से सेट है और डिफ़ॉल्ट रूप से अक्षम है। अपने संगठन के pinned contract version का उपयोग करने के लिए इसे अक्षम रहने दें। अनुरोध को किसी विशिष्ट प्रकाशित version से जोड़ने के लिए इसे सक्षम करें — प्रकाशित versions के लिए [changelog](/hi/developers/v1/changelog) देखें।

## Query parameters और bodies

List-endpoint फ़िल्टर (`limit`, `page_token` और resource-विशिष्ट फ़िल्टर) प्रत्येक अनुरोध में शामिल हैं, लेकिन अक्षम हैं, ताकि नया इम्पोर्ट हर endpoint को सफलतापूर्वक कॉल कर सके। जिन्हें आपको चाहिए उन्हें सक्षम करें और भरें — `page_token` कैसे काम करता है, यह जानने के लिए [Pagination](/hi/developers/v1/pagination) देखें। `POST` operations के request bodies पहले से typed placeholder मानों से भरे होते हैं।

<Note>
  Collection को प्रत्येक contract परिवर्तन पर प्रकाशित OpenAPI spec से पुनः जनरेट किया जाता है — अनुरोधों को अद्यतन रखने के लिए उन्हें संपादित करने के बजाय नई प्रति डाउनलोड करें।
</Note>


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