Skip to main content
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, portanto sempre corresponde ao contrato publicado. Ela abrange todas as operações /v1, agrupadas por recurso, com a autenticação previamente configurada.

​
Download

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

Coleção da API v1 da Living Security

Postman Collection v2.1 com todas as operações /v1 e a autenticação Basic previamente configurada. A coleção baseUrl está em branco — selecione um ambiente regional antes de enviar uma requisição.Baixar a coleção

Ambiente de produção (EUA)

baseUrl predefinido como https://api.us-east-1.livingsecurity.ai/v1, com as variáveis apiKeySecret e contractVersion vazias para preenchimento.Baixar o ambiente de produção dos EUA

Ambiente de produção (UE)

baseUrl predefinido como https://api.eu-west-1.livingsecurity.ai/v1, com as variáveis apiKeySecret e contractVersion vazias para preenchimento.Baixar o ambiente de produção da UE

Modelo de ambiente

As mesmas variáveis com baseUrl em branco, para configurações que não sejam de produção.Baixar o modelo de ambiente

​
Configuração no Postman

1

Importe os arquivos

No Postman, escolha Importação e solte o arquivo da coleção junto com o ambiente de produção (EUA) ou de produção (UE) que corresponda à organização. Consulte Regiões.
2

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 apenas uma vez — copie-o imediatamente. Consulte Chaves de API para obter detalhes.
3

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

Envie uma requisição

Selecione o ambiente regional importado, abra qualquer requisição — por exemplo, Organização → Retrieve the organization — e clique em Enviar. Não envie nada até que um ambiente seja selecionado; o valor baseUrl da coleção está em branco propositalmente.

​
Como a autenticação é previamente 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 nos dois formatos. Usar um cabeçalho Bearer com uma chave de API não exige OAuth. Para usar OAuth, defina Bearer Token como seu token de acesso OAuth, em vez do segredo da chave de API. Consulte Autenticação para escolher um método e Credenciais de cliente OAuth para a configuração de token e cliente.

​
Cabeçalho de versão do contrato

Toda requisição inclui um cabeçalho Living-Security-Version predefinido como {{contractVersion}}, desativado por padrão. Deixe-o desativado para usar a versão de contrato fixada da sua organização. Ative-o para fixar a requisição em uma versão publicada específica — consulte o 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 requisição, porém desativados, de modo que uma importação recém-feita chame todos os endpoints com sucesso. Ative e preencha os que você precisar — consulte Paginação para saber como funciona page_token. Os corpos de requisição das operações POST vêm preenchidos com valores de espaço reservado tipados.
A coleção é gerada novamente a partir da especificação OpenAPI publicada a cada alteração de contrato — baixe uma cópia atualizada em vez de editar as requisições que você deseja manter atualizadas.