/v1,
agrupades per recurs, amb l’autenticació preconfigurada.
Baixada
Els enllaços de baixada us demanaran que inicieu la sessió amb el vostre compte de Living Security
abans de lliurar-vos el fitxer.
Col·lecció de l'API v1 de Living Security
Col·lecció de Postman v2.1 amb totes les operacions
/v1 i l’autenticació Basic
preconfigurada. La variable baseUrl de la col·lecció és buida: seleccioneu un
entorn regional abans d’enviar cap sol·licitud.Baixa la col·leccióEntorn de producció (EUA)
baseUrl preconfigurat amb https://api.us-east-1.livingsecurity.ai/v1, amb
les variables apiKeySecret i contractVersion buides per emplenar.Baixa l’entorn de producció dels EUAEntorn de producció (UE)
baseUrl preconfigurat amb https://api.eu-west-1.livingsecurity.ai/v1, amb
les variables apiKeySecret i contractVersion buides per emplenar.Baixa l’entorn de producció de la UEPlantilla d'entorn
Les mateixes variables amb un
baseUrl en blanc, per a configuracions que no són de producció.Baixa la plantilla d’entornConfiguració a Postman
1
Importeu els fitxers
A Postman, trieu Import i deixeu anar el fitxer de la col·lecció i l’entorn
Production (US) o Production (EU) que correspongui a
l’organització. Vegeu Regions.
2
Creeu una clau d'API
Al Dashboard, obriu Settings → Integrations & Developers →
Developer Hub, creeu un compte de servei i creeu una clau d’API. El secret de la clau comença per
lsk_live_ i
només es mostra una vegada: copieu-lo immediatament. Per a més informació, vegeu
Claus d’API.3
Enganxeu el secret
Definiu la variable
apiKeySecret, ja sigui a l’entorn importat
(recomanat; és una variable de tipus secret) o a la pestanya
Variables de la col·lecció.4
Envieu una sol·licitud
Seleccioneu l’entorn regional importat, obriu qualsevol sol·licitud (per exemple,
Organization → Retrieve the organization) i premeu Send. No
envieu res fins que hàgiu seleccionat un entorn; la variable
baseUrl de la col·lecció és buida
expressament.Com es preconfigura l’autenticació
La col·lecció defineix l’autenticació Basic a nivell de col·lecció amb el nom d’usuariapikey
i la contrasenya {{apiKeySecret}}. L’API accepta el secret de la clau en qualsevol dels dos
camps de l’autenticació Basic, de manera que funciona tal com està un cop s’ha definit la variable.
Si preferiu l’autenticació de tipus bearer, canvieu el tipus d’Authorization
de la col·lecció a Bearer Token i useu {{apiKeySecret}} com a testimoni: l’API
accepta el mateix secret d’ambdues maneres.
Utilitzar una capçalera Bearer amb una clau d’API no requereix OAuth. Per utilitzar OAuth,
establiu Bearer Token al vostre testimoni d’accés OAuth en lloc del secret de la clau d’API.
Vegeu Autenticació per triar un mètode i
Credencials de client OAuth per configurar el testimoni i el client.
Capçalera de versió del contracte
Cada sol·licitud inclou una capçaleraLiving-Security-Version preconfigurada amb
{{contractVersion}}, desactivada per defecte. Deixeu-la desactivada per utilitzar la versió del contracte
fixada per a la vostra organització. Activeu-la per fixar la sol·licitud a una
versió publicada concreta; per a les versions publicades, vegeu el registre de canvis.
Paràmetres de consulta i cossos
Els filtres dels punts finals de llista (limit, page_token i els filtres específics de cada recurs)
s’inclouen a cada sol·licitud però estan desactivats, de manera que una importació nova crida correctament
a tots els punts finals. Activeu i empleneu els que necessiteu; vegeu
Paginació per saber com funciona page_token. Els cossos
de sol·licitud de les operacions POST venen emplenats amb valors de marcador de posició tipats.
La col·lecció es regenera a partir de l’especificació OpenAPI publicada a cada canvi
de contracte: baixeu-ne una còpia nova en lloc d’editar les sol·licituds que
vulgueu mantenir actualitzades.