Primeiros passos

Autenticação

A API usa API keys secretas enviadas no cabeçalho Authorization.

Inclua a chave em todas as requisições:

HTTP

GET /v1/balance HTTP/1.1
Host: api.integrator.co26.com.br
Authorization: Bearer itg_live_SUA_CHAVE

Criar, guardar e revogar

Crie chaves no painel em Integração → API keys. Dê um nome que diga onde ela é usada ("ERP produção", "servidor de testes").
A chave completa aparece uma única vez. Depois o painel mostra só o prefixo (itg_live_ab12…) e quando ela foi usada pela última vez.
Guardamos apenas um hash da chave. Se ela for perdida, gere outra.
Para trocar uma chave sem parar a operação: crie a nova, faça o deploy e só então revogue a antiga.

Nunca exponha a API key

Ela dá acesso a criar cobranças na sua conta. Não coloque em apps mobile, no navegador, em repositórios públicos nem na maquininha. A maquininha usa outra credencial, o token do terminal, que só serve para buscar e reportar cobranças daquele aparelho.

Respostas de autenticação

Chave ausente, inválida ou revogada devolve 401 com invalid_api_key. Uma conta bloqueada continua consultando dados, mas recebe 403 account_blocked ao tentar criar cobranças.

JSON

{
  "error": {
    "code": "invalid_api_key",
    "message": "Envie uma API key válida no cabeçalho Authorization: Bearer itg_live_..."
  }
}

Anterior← Início rápido PróximoTerminais e pareamento →