/v1 operaciones,
agrupadas por recurso, con la autenticación preconfigurada.
Descarga
Los enlaces de descarga le solicitan que inicie sesión con su cuenta de Living Security
antes de entregarle el archivo.
Colección de la API v1 de Living Security
Postman Collection v2.1 con todas las operaciones
/v1 y la autenticación Basic
preconfigurada. La colección baseUrl está en blanco: seleccione un
entorno regional antes de enviar una solicitud.Descargar la colecciónEntorno de producción (EE. UU.)
baseUrl preconfigurado con https://api.us-east-1.livingsecurity.ai/v1, con
las variables apiKeySecret y contractVersion vacías para que las complete.Descargar el entorno de producción de EE. UU.Entorno de producción (UE)
baseUrl preconfigurado con https://api.eu-west-1.livingsecurity.ai/v1, con
las variables apiKeySecret y contractVersion vacías para que las complete.Descargar el entorno de producción de la UEPlantilla de entorno
Las mismas variables con un
baseUrl en blanco, para configuraciones que no son de producción.Descargar la plantilla de entornoConfiguración en Postman
1
Importe los archivos
En Postman, elija Import y arrastre el archivo de la colección junto con el
entorno Production (US) o Production (EU) que corresponda a la
organización. Consulte Regiones.
2
Cree una clave de API
En el Panel de control, abra Configuración → Integraciones & Developers →
Developer Hub, cree una cuenta de servicio y, a continuación, una clave de API. El secreto de la clave comienza con
lsk_live_ y
se muestra una sola vez: cópielo de inmediato. Consulte
Claves de API para obtener más información.3
Pegue el secreto
Defina la variable
apiKeySecret, ya sea en el entorno importado
(recomendado; es una variable de tipo secreto) o en la pestaña
Variables de la colección.4
Envíe una solicitud
Seleccione el entorno regional importado, abra cualquier solicitud (por ejemplo,
Organización → Retrieve the organization) y haga clic en Enviar. No
envíe ninguna solicitud hasta haber seleccionado un entorno; la variable
baseUrl de la colección está en blanco
a propósito.Cómo se preconfigura la autenticación
La colección define la autenticación Basic a nivel de colección con el nombre de usuarioapikey
y la contraseña {{apiKeySecret}}. La API acepta el secreto de la clave en cualquiera de los
campos de autenticación Basic, por lo que funciona tal cual una vez definida la variable.
Si prefiere la autenticación mediante token de portador (bearer), cambie el tipo de Authorization
de la colección a Bearer Token y use {{apiKeySecret}} como token; la API
acepta el mismo secreto de ambas formas.
Usar un encabezado Bearer con una clave de API no requiere OAuth. Para usar OAuth,
establezca Bearer Token con su token de acceso de OAuth en lugar del secreto de la clave de API.
Consulte Autenticación para elegir un método y
Credenciales de cliente de OAuth para la configuración del token y del cliente.
Encabezado de versión del contrato
Cada solicitud incluye un encabezadoLiving-Security-Version preconfigurado con
{{contractVersion}}, deshabilitado de forma predeterminada. Déjelo deshabilitado para usar la versión
del contrato fijada para su organización. Habilítelo para fijar la solicitud a una
versión publicada específica; consulte el registro de cambios
para ver las versiones publicadas.
Parámetros de consulta y cuerpos
Los filtros de los endpoints de lista (limit, page_token y los filtros específicos de cada recurso)
se incluyen en cada solicitud, pero están deshabilitados, de modo que una importación nueva llama correctamente a todos los
endpoints. Habilite y complete los que necesite; consulte
Paginación para saber cómo funciona page_token. Los cuerpos
de solicitud de las operaciones POST vienen rellenados con valores de marcador de posición tipificados.
La colección se regenera a partir de la especificación OpenAPI publicada con cada cambio
del contrato: descargue una copia nueva en lugar de editar las solicitudes que
desea mantener actualizadas.