FAQ - Perguntas Frequentes sobre a API da Conta Azul

Este FAQ reúne as principais dúvidas de desenvolvedores que integram seus sistemas com a API da Conta Azul.

🔐 Autenticação e Autorização

Como faço a autenticação na API da Conta Azul?

A autenticação é feita via OAuth 2.0. Você deve:

Redirecionar o usuário para a URL de autorização.
Trocar o código de autorização por um token de acesso.
Usar o token de acesso para chamadas autenticadas.

Qual o tempo de expiração do código de autorização obtido?

O código de autorização tem validade de 3 minutos. Desta forma após obter o código você terá 3 minutos para realizar a troca por um token de acesso.

Como conectar meu aplicativo a múltiplos clientes (empresas Conta Azul)?

Você deve repetir o fluxo de autorização de OAuth para cada empresa que desejar integrar. Cada autorização gera um token exclusivo por empresa

A API tem limite de requisições?

Sim. A Conta Azul aplica rate limits nas integrações. Os detalhes do limite devem ser tratados via headers da resposta HTTP. Hoje nossos limites são: 50 chamadas por minuto e até 10 por segundo.

Existe webhook para receber eventos da Conta Azul?

Ainda não está disponível nativamente. Você pode simular esse comportamento criando um polling recorrente nos endpoints.

Existe ambiente de homologação ou sandbox?

Não. Ao criar um APP o desenvolvedor tem acesso a uma conta trial com duração de 3 dias e que pode ser extendido mediante solicitação.