Skip to main content
Koleksi Postman Living Security API v1 dihasilkan dari spesifikasi OpenAPI yang sama dengan yang mendukung Referensi API v1, sehingga selalu sesuai dengan kontrak yang dipublikasikan. Koleksi ini mencakup setiap operasi /v1, dikelompokkan berdasarkan sumber daya, dengan autentikasi yang sudah dikonfigurasi sebelumnya.

Unduh

Tautan unduhan akan meminta Anda masuk dengan akun Living Security Anda sebelum file disajikan.

Koleksi Living Security API v1

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.Unduh koleksi

Lingkungan produksi (US)

baseUrl yang sudah diatur ke https://api.us-east-1.livingsecurity.ai/v1, dengan variabel apiKeySecret dan contractVersion kosong untuk Anda isi.Unduh lingkungan produksi US

Lingkungan produksi (EU)

baseUrl yang sudah diatur ke https://api.eu-west-1.livingsecurity.ai/v1, dengan variabel apiKeySecret dan contractVersion kosong untuk Anda isi.Unduh lingkungan produksi EU

Templat lingkungan

Variabel yang sama dengan baseUrl kosong, untuk penyiapan non-produksi.Unduh templat lingkungan

Penyiapan di Postman

1

Impor file

Di Postman, pilih Impor lalu masukkan file koleksi beserta lingkungan Production (US) atau Production (EU) yang sesuai dengan organisasi. Lihat Wilayah.
2

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 untuk detailnya.
3

Tempel rahasia

Atur variabel apiKeySecret — baik di lingkungan yang diimpor (disarankan; variabel ini bertipe rahasia) maupun di tab Variabel pada koleksi.
4

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.

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 untuk memilih metode dan Kredensial klien 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 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 untuk cara kerja page_token. Isi permintaan pada operasi POST sudah terisi dengan nilai placeholder bertipe.
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.