API REST

Visão geral

  • A autenticação é obrigatória para consumir os recursos protegidos.

  • O token obtido deve ser enviado no cabeçalho Authorization.

  • Os relatórios podem ser consultados para descoberta, estrutura e download dos dados.

  • A API foi desenhada para facilitar integrações com sistemas externos e automações do cliente.

Métodos HTTP utilizados

Método

Uso

GET

Recuperar informações e listar recursos

POST

Enviar requisições de autenticação e download

Formatos de resposta

  • application/json

  • text/json

  • application/xml

  • text/xml

Códigos de resposta mais comuns

Código HTTP

Descrição

200 OK

Requisição concluída com sucesso

400 Bad Request

Requisição inválida ou com parâmetros obrigatórios faltando

401 Unauthorized

Credenciais inválidas ou ausentes

403 Forbidden

Requisição autenticada, mas sem autorização

404 Not Found

Recurso não encontrado

500 Internal Server Error

Falha interna ao processar a requisição

502 Bad Gateway

Resposta inválida do servidor upstream

503 Service Unavailable

Serviço temporariamente indisponível

Próximos passos

  1. Acessar a seção de autenticação para obter o token.

  2. Consultar a lista de relatórios disponíveis.

  3. Consultar os dados do relatório desejado.