/v1 Operationen ab,
gruppiert nach Ressourcen, mit vorkonfigurierter Authentifizierung.
Download
Die Download-Links fordern Sie auf, sich mit Ihrem Living Security Konto anzumelden,
bevor die Datei bereitgestellt wird.
Living Security API v1 Collection
Postman Collection v2.1 mit allen
/v1 Operationen und vorkonfigurierter
Basic-Authentifizierung. Collection baseUrl ist leer – wählen Sie eine regionale
Umgebung aus, bevor Sie eine Anfrage senden.Collection herunterladenProduktionsumgebung (US)
baseUrl voreingestellt auf https://api.us-east-1.livingsecurity.ai/v1, mit
leeren Variablen apiKeySecret und contractVersion, die Sie ausfüllen müssen.US-Produktionsumgebung herunterladenProduktionsumgebung (EU)
baseUrl voreingestellt auf https://api.eu-west-1.livingsecurity.ai/v1, mit
leeren Variablen apiKeySecret und contractVersion, die Sie ausfüllen müssen.EU-Produktionsumgebung herunterladenUmgebungsvorlage
Dieselben Variablen mit leerem
baseUrl, für Nicht-Produktionsumgebungen.Umgebungsvorlage herunterladenEinrichtung in Postman
1
Dateien importieren
Wählen Sie in Postman Import und ziehen Sie die Collection-Datei sowie
die Umgebung Production (US) oder Production (EU) hinein, die zur
Organisation passt. Siehe Regionen.
2
API-Schlüssel erstellen
Öffnen Sie im Dashboard Einstellungen → Integrationen & Developers →
Developer Hub, erstellen Sie ein Servicekonto und anschließend einen API-Schlüssel. Das Schlüsselgeheimnis beginnt mit
lsk_live_ und
wird nur einmal angezeigt – kopieren Sie es sofort. Weitere Informationen finden Sie unter
API-Schlüssel.3
Geheimnis einfügen
Legen Sie die Variable
apiKeySecret fest – entweder in der importierten Umgebung
(empfohlen; es handelt sich um eine Variable vom Typ „secret“) oder auf der Registerkarte
Variables der Collection.4
Anfrage senden
Wählen Sie die importierte regionale Umgebung aus, öffnen Sie eine beliebige Anfrage – zum Beispiel
Organization → Retrieve the organization – und klicken Sie auf Senden. Senden Sie
erst, wenn eine Umgebung ausgewählt ist; die Collection-Variable
baseUrl ist absichtlich
leer.So ist die Authentifizierung vorkonfiguriert
Die Collection legt Basic-Authentifizierung auf Collection-Ebene fest, mit dem Benutzernamenapikey
und dem Passwort {{apiKeySecret}}. Die API akzeptiert das Schlüsselgeheimnis in beiden
Basic-Auth-Feldern, sodass dies ohne Änderung funktioniert, sobald die Variable gesetzt ist.
Wenn Sie die Bearer-Authentifizierung bevorzugen, ändern Sie den Typ unter Authorization
der Collection in Bearer Token und verwenden Sie {{apiKeySecret}} als Token – die API
akzeptiert dasselbe Geheimnis auf beide Arten.
Die Verwendung eines Bearer-Headers mit einem API-Schlüssel erfordert kein OAuth. Um OAuth zu verwenden,
setzen Sie Bearer Token auf Ihr OAuth-Zugriffstoken anstelle des Geheimnisses des API-Schlüssels.
Unter Authentifizierung erfahren Sie, wie Sie eine Methode auswählen, und unter
OAuth-Client-Credentials finden Sie die Einrichtung von Token und Client.
Header für die Vertragsversion
Jede Anfrage enthält einen HeaderLiving-Security-Version, der auf
{{contractVersion}} voreingestellt und standardmäßig deaktiviert ist. Lassen Sie ihn deaktiviert, um die
festgelegte Vertragsversion Ihrer Organisation zu verwenden. Aktivieren Sie ihn, um die Anfrage auf eine
bestimmte veröffentlichte Version festzulegen – die veröffentlichten Versionen finden Sie im Changelog.
Abfrageparameter und Request-Bodys
Filter für List-Endpunkte (limit, page_token und ressourcenspezifische Filter)
sind in jeder Anfrage enthalten, aber deaktiviert, sodass ein frischer Import jeden
Endpunkt erfolgreich aufruft. Aktivieren und füllen Sie diejenigen aus, die Sie benötigen – unter
Paginierung erfahren Sie, wie page_token funktioniert. Request-Bodys
bei POST-Operationen sind mit typisierten Platzhalterwerten vorausgefüllt.
Die Collection wird bei jeder Vertragsänderung aus der veröffentlichten OpenAPI-Spezifikation neu generiert –
laden Sie eine aktuelle Kopie herunter, anstatt Anfragen zu bearbeiten, die
aktuell bleiben sollen.