> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Colección de Postman

> Importe la colección de Postman generada de la API pública de Living Security, pegue una clave de API y llame a /v1 en cuestión de minutos.

La colección de Postman de la API v1 de Living Security se genera a partir de la misma
especificación OpenAPI en la que se basa la [Referencia de la API v1](/v1-reference/openapi-v1.json),
por lo que siempre coincide con el contrato publicado. Abarca las `/v1` operaciones,
agrupadas por recurso, con la autenticación preconfigurada.

## Descarga

<Info>
  Los enlaces de descarga le solicitan que inicie sesión con su cuenta de Living Security
  antes de entregarle el archivo.
</Info>

<CardGroup cols={1}>
  <Card title="Colección de la API v1 de Living Security" icon="download">
    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.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Descargar la colección</a>
  </Card>

  <Card title="Entorno de producción (EE. UU.)" icon="download">
    `baseUrl` preconfigurado con `https://api.us-east-1.livingsecurity.ai/v1`, con
    las variables `apiKeySecret` y `contractVersion` vacías para que las complete.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Descargar el entorno de producción de EE. UU.</a>
  </Card>

  <Card title="Entorno de producción (UE)" icon="download">
    `baseUrl` preconfigurado con `https://api.eu-west-1.livingsecurity.ai/v1`, con
    las variables `apiKeySecret` y `contractVersion` vacías para que las complete.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Descargar el entorno de producción de la UE</a>
  </Card>

  <Card title="Plantilla de entorno" icon="download">
    Las mismas variables con un `baseUrl` en blanco, para configuraciones que no son de producción.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Descargar la plantilla de entorno</a>
  </Card>
</CardGroup>

## Configuración en Postman

<Steps>
  <Step title="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](/es/developers/v1/regions).
  </Step>

  <Step title="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](/es/developers/developer-hub/api-keys) para obtener más información.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Cómo se preconfigura la autenticación

La colección define la autenticación Basic a nivel de colección con el nombre de usuario `apikey`
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](/es/developers/v1/authentication) para elegir un método y
[Credenciales de cliente de OAuth](/es/developers/v1/oauth) para la configuración del token y del cliente.

## Encabezado de versión del contrato

Cada solicitud incluye un encabezado `Living-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](/es/developers/v1/changelog)
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](/es/developers/v1/pagination) 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.

<Note>
  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.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.