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

# Koleksi Postman

> Impor koleksi Postman Living Security Public API yang dihasilkan, tempel kunci API, dan panggil /v1 dalam hitungan menit.

Koleksi Postman Living Security API v1 dihasilkan dari spesifikasi OpenAPI yang sama
dengan yang mendukung [Referensi API v1](/v1-reference/openapi-v1.json),
sehingga selalu sesuai dengan kontrak yang dipublikasikan. Koleksi ini mencakup setiap operasi `/v1`,
dikelompokkan berdasarkan sumber daya, dengan autentikasi yang sudah dikonfigurasi sebelumnya.

## Unduh

<Info>
  Tautan unduhan akan meminta Anda masuk dengan akun Living Security Anda
  sebelum file disajikan.
</Info>

<CardGroup cols={1}>
  <Card title="Koleksi Living Security API v1" icon="download">
    Postman Collection v2.1 dengan semua operasi `/v1` dan autentikasi Basic
    yang sudah dikonfigurasi sebelumnya. Koleksi `baseUrl` sengaja dikosongkan — pilih
    lingkungan regional sebelum Anda mengirim permintaan.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Unduh koleksi</a>
  </Card>

  <Card title="Lingkungan produksi (US)" icon="download">
    `baseUrl` yang sudah diatur ke `https://api.us-east-1.livingsecurity.ai/v1`, dengan
    variabel `apiKeySecret` dan `contractVersion` kosong untuk Anda isi.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Unduh lingkungan produksi US</a>
  </Card>

  <Card title="Lingkungan produksi (EU)" icon="download">
    `baseUrl` yang sudah diatur ke `https://api.eu-west-1.livingsecurity.ai/v1`, dengan
    variabel `apiKeySecret` dan `contractVersion` kosong untuk Anda isi.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Unduh lingkungan produksi EU</a>
  </Card>

  <Card title="Templat lingkungan" icon="download">
    Variabel yang sama dengan `baseUrl` kosong, untuk penyiapan non-produksi.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Unduh templat lingkungan</a>
  </Card>
</CardGroup>

## Penyiapan di Postman

<Steps>
  <Step title="Impor file">
    Di Postman, pilih **Impor** lalu masukkan file koleksi beserta lingkungan
    Production (US) atau Production (EU) yang sesuai dengan organisasi.
    Lihat [Wilayah](/id/developers/v1/regions).
  </Step>

  <Step title="Buat kunci API">
    Di Dasbor, buka **Pengaturan → Integrasi & Developers →
    Developer Hub**, buat akun layanan, lalu buat kunci API. Rahasia kunci diawali dengan `lsk_live_` dan
    hanya ditampilkan sekali — segera salin. Lihat
    [Kunci API](/id/developers/developer-hub/api-keys) untuk detailnya.
  </Step>

  <Step title="Tempel rahasia">
    Atur variabel `apiKeySecret` — baik di lingkungan yang diimpor
    (disarankan; variabel ini bertipe rahasia) maupun di tab
    **Variabel** pada koleksi.
  </Step>

  <Step title="Kirim permintaan">
    Pilih lingkungan regional yang diimpor, buka permintaan apa pun — misalnya
    **Organisasi → Retrieve the organization** — lalu klik **Kirim**. Jangan
    mengirim sebelum lingkungan dipilih; `baseUrl` koleksi sengaja
    dikosongkan.
  </Step>
</Steps>

## Cara autentikasi dikonfigurasi sebelumnya

Koleksi ini menetapkan autentikasi Basic pada tingkat koleksi dengan nama pengguna `apikey`
dan kata sandi `{{apiKeySecret}}`. API menerima rahasia kunci pada salah satu kolom
autentikasi Basic, sehingga konfigurasi ini dapat langsung digunakan setelah variabel diatur.

Jika Anda lebih memilih autentikasi bearer, ubah tipe **Authorization**
koleksi menjadi **Bearer Token** dan gunakan `{{apiKeySecret}}` sebagai token — API
menerima rahasia yang sama dengan kedua cara tersebut.

Penggunaan header Bearer dengan kunci API tidak memerlukan OAuth. Untuk menggunakan OAuth,
atur **Bearer Token** ke token akses OAuth Anda, bukan rahasia kunci API.
Lihat [Autentikasi](/id/developers/v1/authentication) untuk memilih metode dan
[Kredensial klien OAuth](/id/developers/v1/oauth) untuk penyiapan token dan klien.

## Header versi kontrak

Setiap permintaan membawa header `Living-Security-Version` yang sudah diatur ke
`{{contractVersion}}`, dan dinonaktifkan secara default. Biarkan tetap nonaktif untuk menggunakan versi kontrak
yang disematkan pada organisasi Anda. Aktifkan untuk menyematkan permintaan ke
versi tertentu yang telah dipublikasikan — lihat [changelog](/id/developers/v1/changelog)
untuk versi yang telah dipublikasikan.

## Parameter kueri dan isi permintaan

Filter endpoint daftar (`limit`, `page_token`, dan filter khusus sumber daya)
disertakan pada setiap permintaan tetapi dinonaktifkan, sehingga impor baru dapat memanggil setiap
endpoint dengan berhasil. Aktifkan dan isi yang Anda perlukan — lihat
[Paginasi](/id/developers/v1/pagination) untuk cara kerja `page_token`. Isi
permintaan pada operasi `POST` sudah terisi dengan nilai placeholder bertipe.

<Note>
  Koleksi ini dihasilkan ulang dari spesifikasi OpenAPI yang dipublikasikan setiap kali
  kontrak berubah — unduh salinan terbaru alih-alih mengedit permintaan yang
  ingin Anda jaga agar tetap mutakhir.
</Note>


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