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 /v1 operações, agrupadas por recurso, com a autenticação pré-configurada.

​
Download

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

Coleção da API v1 da Living Security

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.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 serem preenchidas.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 serem preenchidas.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 Import e solte o arquivo da coleção junto com o ambiente Production (US) ou Production (EU) 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 uma única 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 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.

​
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 para escolher um método e Credenciais de cliente 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 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 para saber como page_token funciona. Os corpos das solicitações nas operações POST são preenchidos previamente com valores de exemplo tipados.
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.