Skip to main content
Living Security API v1 Postman koleksiyonu, API v1 Başvurusu’nu oluşturan OpenAPI spesifikasyonundan oluşturulur; bu nedenle yayımlanmış sözleşmeyle her zaman uyumludur. Kaynaklara göre gruplandırılmış /v1 işlemin tamamını kapsar ve kimlik doğrulama önceden yapılandırılmıştır.

İndirme

İndirme bağlantıları, dosya sunulmadan önce Living Security hesabınızla oturum açmanızı ister.

Living Security API v1 koleksiyonu

Tüm /v1 işlemi içeren ve Basic kimlik doğrulaması önceden yapılandırılmış Postman Collection v2.1. Koleksiyonun baseUrl değeri boştur — bir istek göndermeden önce bir bölgesel ortam seçin.Koleksiyonu indirin

Üretim (ABD) ortamı

baseUrl değeri https://api.us-east-1.livingsecurity.ai/v1 olarak önceden ayarlanmıştır; doldurmanız gereken boş apiKeySecret ve contractVersion değişkenleri bulunur.ABD üretim ortamını indirin

Üretim (AB) ortamı

baseUrl değeri https://api.eu-west-1.livingsecurity.ai/v1 olarak önceden ayarlanmıştır; doldurmanız gereken boş apiKeySecret ve contractVersion değişkenleri bulunur.AB üretim ortamını indirin

Ortam şablonu

Üretim dışı kurulumlar için, boş bir baseUrl içeren aynı değişkenler.Ortam şablonunu indirin

Postman’de kurulum

1

Dosyaları içe aktarın

Postman’de İçe Aktarma’yı seçin ve koleksiyon dosyasını, organizasyonunuza uygun Üretim (ABD) veya Üretim (AB) ortamıyla birlikte bırakın. Bkz. Bölgeler.
2

Bir API anahtarı oluşturun

Kontrol Paneli’nde Ayarlar → Entegrasyonlar ve Geliştiriciler → Developer Hub yolunu açın, bir hizmet hesabı oluşturun ve bir API anahtarı oluşturun. Anahtar gizli değeri lsk_live_ ile başlar ve yalnızca bir kez gösterilir — hemen kopyalayın. Ayrıntılar için bkz. API anahtarları.
3

Gizli değeri yapıştırın

apiKeySecret değişkenini ayarlayın — içe aktarılan ortamda (önerilir; gizli türde bir değişkendir) veya koleksiyonun Değişkenleri sekmesinde.
4

Bir istek gönderin

İçe aktarılan bölgesel ortamı seçin, herhangi bir isteği açın — örneğin Organizasyonu → Retrieve the organization — ve Gönder’e tıklayın. Bir ortam seçilmeden göndermeyin; koleksiyonun baseUrl değeri bilerek boş bırakılmıştır.

Kimlik doğrulama nasıl önceden yapılandırılır

Koleksiyon, Basic kimlik doğrulamasını koleksiyon düzeyinde ayarlar; kullanıcı adı apikey, parola {{apiKeySecret}} şeklindedir. API, anahtar gizli değerini her iki Basic kimlik doğrulama alanında da kabul eder; dolayısıyla değişken ayarlandıktan sonra bu yapılandırma olduğu gibi çalışır. Bearer kimlik doğrulamasını tercih ederseniz koleksiyonun Authorization türünü Bearer Token olarak değiştirin ve belirteç olarak {{apiKeySecret}} değerini kullanın — API aynı gizli değeri her iki şekilde de kabul eder. Bir API anahtarıyla Bearer üst bilgisi kullanmak OAuth gerektirmez. OAuth kullanmak için Bearer Token değerini API anahtarı gizli değeri yerine OAuth erişim belirtecinizle ayarlayın. Bir yöntem seçmek için Kimlik doğrulama, belirteç ve istemci kurulumu için OAuth istemci kimlik bilgileri sayfalarına bakın.

Sözleşme sürümü üst bilgisi

Her istek, varsayılan olarak devre dışı ve {{contractVersion}} değerine önceden ayarlanmış bir Living-Security-Version üst bilgisi taşır. Organizasyonunuza sabitlenmiş sözleşme sürümünü kullanmak için devre dışı bırakın. İsteği yayımlanmış belirli bir sürüme sabitlemek için etkinleştirin — yayımlanmış sürümler için değişiklik günlüğüne bakın.

Sorgu parametreleri ve gövdeler

Liste uç noktalarının filtreleri (limit, page_token ve kaynağa özgü filtreler) her isteğe dahil edilmiştir ancak devre dışıdır; böylece yeni bir içe aktarma her uç noktayı başarıyla çağırır. İhtiyacınız olanları etkinleştirip doldurun — page_token değerinin nasıl çalıştığı için bkz. Sayfalama. POST işlemlerinin istek gövdeleri, türlerine uygun yer tutucu değerlerle önceden doldurulmuştur.
Koleksiyon, her sözleşme değişikliğinde yayımlanmış OpenAPI spesifikasyonundan yeniden oluşturulur — güncel kalmasını istediğiniz istekleri düzenlemek yerine yeni bir kopya indirin.