> ## 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.

# Coleção do Postman

> Importe a coleção do Postman da API Pública da Living Security gerada automaticamente, cole uma chave de API e chame /v1 em poucos minutos.

A coleção do Postman da API v1 da Living Security é gerada a partir da mesma
especificação OpenAPI que alimenta a [Referência da API v1](/v1-reference/openapi-v1.json),
portanto sempre corresponde ao contrato publicado. Ela abrange todas as `/v1` operações,
agrupadas por recurso, com a autenticação pré-configurada.

## Download

<Info>
  Os links de download solicitam que você faça login com a sua conta da Living Security
  antes de o arquivo ser disponibilizado.
</Info>

<CardGroup cols={1}>
  <Card title="Coleção da API v1 da Living Security" icon="download">
    Coleção do Postman v2.1 com todas as `/v1` operações e autenticação Basic
    pré-configurada. A coleção `baseUrl` está em branco — selecione um ambiente
    regional antes de enviar uma solicitação.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Baixar a coleção</a>
  </Card>

  <Card title="Ambiente de produção (EUA)" icon="download">
    `baseUrl` predefinido como `https://api.us-east-1.livingsecurity.ai/v1`, com
    as variáveis `apiKeySecret` e `contractVersion` vazias para serem preenchidas.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Baixar o ambiente de produção dos EUA</a>
  </Card>

  <Card title="Ambiente de produção (UE)" icon="download">
    `baseUrl` predefinido como `https://api.eu-west-1.livingsecurity.ai/v1`, com
    as variáveis `apiKeySecret` e `contractVersion` vazias para serem preenchidas.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Baixar o ambiente de produção da UE</a>
  </Card>

  <Card title="Modelo de ambiente" icon="download">
    As mesmas variáveis com `baseUrl` em branco, para configurações que não sejam de produção.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Baixar o modelo de ambiente</a>
  </Card>
</CardGroup>

## Configuração no Postman

<Steps>
  <Step title="Importe os arquivos">
    No Postman, escolha **Import** e solte o arquivo da coleção junto com o
    ambiente Production (US) ou Production (EU) que corresponda à
    organização. Consulte [Regiões](/pt/developers/v1/regions).
  </Step>

  <Step title="Crie uma chave de API">
    No Painel, abra **Configurações → Integrações & Developers →
    Developer Hub**, crie uma conta de serviço e crie uma chave de API. O segredo da chave começa com `lsk_live_` e
    é exibido uma única vez — copie-o imediatamente. Consulte
    [Chaves de API](/pt/developers/developer-hub/api-keys) para obter detalhes.
  </Step>

  <Step title="Cole o segredo">
    Defina a variável `apiKeySecret` — no ambiente importado
    (recomendado; é uma variável do tipo secreto) ou na guia
    **Variáveis** da coleção.
  </Step>

  <Step title="Envie uma solicitação">
    Selecione o ambiente regional importado, abra qualquer solicitação — por exemplo,
    **Organização → Retrieve the organization** — e clique em **Enviar**. Não
    envie enquanto um ambiente não estiver selecionado; a coleção `baseUrl` está em branco
    de propósito.
  </Step>
</Steps>

## Como a autenticação é pré-configurada

A coleção define a autenticação Basic no nível da coleção, com o nome de usuário `apikey`
e a senha `{{apiKeySecret}}`. A API aceita o segredo da chave em qualquer um dos
campos de autenticação Basic, portanto isso funciona sem alterações assim que a variável for definida.

Se preferir a autenticação bearer, altere o tipo de **Authorization** da coleção
para **Bearer Token** e use `{{apiKeySecret}}` como token — a API
aceita o mesmo segredo nas duas formas.

Usar um cabeçalho Bearer com uma chave de API não exige OAuth. Para usar OAuth,
defina **Bearer Token** como o seu token de acesso OAuth em vez do segredo da chave de API.
Consulte [Autenticação](/pt/developers/v1/authentication) para escolher um método e
[Credenciais de cliente OAuth](/pt/developers/v1/oauth) para a configuração de tokens e clientes.

## Cabeçalho de versão do contrato

Toda solicitação contém um cabeçalho `Living-Security-Version` predefinido como
`{{contractVersion}}`, desativado por padrão. Deixe-o desativado para usar a versão do contrato
fixada da sua organização. Ative-o para fixar a solicitação em uma
versão publicada específica — consulte o [registro de alterações](/pt/developers/v1/changelog)
para ver as versões publicadas.

## Parâmetros de consulta e corpos

Os filtros dos endpoints de listagem (`limit`, `page_token` e filtros específicos de cada recurso)
estão incluídos em cada solicitação, porém desativados, de modo que uma importação nova chame todos os
endpoints com sucesso. Ative e preencha os que forem necessários — consulte
[Paginação](/pt/developers/v1/pagination) para saber como `page_token` funciona. Os corpos
das solicitações nas operações `POST` são preenchidos previamente com valores de exemplo tipados.

<Note>
  A coleção é regenerada a partir da especificação OpenAPI publicada a cada
  alteração de contrato — baixe uma cópia atualizada em vez de editar as solicitações que
  deseja manter atualizadas.
</Note>


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