Documentação / Guias

Autenticação

Envie seu token com segurança em cada requisição.

Envie o token no cabeçalho Authorization de cada requisição. Os exemplos desta documentação usam o formato Bearer:

HTTP

Authorization: Bearer SEU_TOKEN
Accept: application/json

A URL base da API é https://api.nextapi.com.br. Os endpoints documentados usam o prefixo /v1.

Como obter e usar a chave

Entre no painel da NextAPI e abra a área de chaves de API.
Gere uma chave para sua integração.
Configure o token no servidor e envie-o pelo cabeçalho nas chamadas à API.

Onde guardar o token

Use variáveis de ambiente ou o gerenciador de segredos da sua infraestrutura. Não coloque o token em código do navegador, repositórios públicos ou URLs. Uma aplicação web deve chamar seu próprio backend, que faz a consulta autenticada à NextAPI.

Falhas de autenticação

Nas consultas REST, a ausência do cabeçalho pode retornar HTTP 400 com código 1001. Um token inválido retorna HTTP 401 com código 1002. Verifique o status HTTP e, quando disponível, o campo code da resposta.

JSON · exemplo de erro

{
  "status": "Erro",
  "code": 1002,
  "message": "Token de autenticação não informado ou inválido."
}

Não repita automaticamente uma chamada com a mesma credencial inválida. Corrija a configuração e tente novamente.