Last updated
Novo Portal de Desenvolvedor

Em breve, a Conta Azul lançará uma nova experiência de APIs! Até o lançamento, você pode continuar usando a API atual, com documentação disponível aqui.

Credenciais

Antes de começar a consumir a API da Conta Azul, siga estes passos essenciais para configurar seu ambiente de desenvolvimento.

1. Crie sua conta de desenvolvedor

Primeiro, crie uma conta no Gerenciador de Aplicações da Conta Azul. Essa conta permite que você gerencie todas as suas aplicações integradas ao Conta Azul Pro.

Seja seu objetivo criar um app público (utilizado por diversos clientes) ou um app privado (exclusivamente para uso próprio), será necessário ter uma conta registrada.

2. Crie uma nova aplicação

Após efetuar o login no Gerenciador de Aplicações:

  • Clique em "Nova Aplicação".
  • Preencha as informações solicitadas, como nome, descrição e o tipo de aplicação (pública ou privada).
  • Finalize clicando em "Salvar".

3. Obtenha suas credenciais

Ao concluir a criação da aplicação, serão exibidas duas informações importantes:

  • client_id
  • client_secret

Essas credenciais são essenciais para o processo de autenticação OAuth2 e são necessárias para gerar o access_token.

Dica: Você poderá acessar essas credenciais a qualquer momento na seção "Minhas Aplicações" do portal.

Além dessas credenciais, você também receberá um usuário e senha para acessar uma conta teste do Conta Azul Pro (ERP), permitindo validar suas integrações antes de colocá-las em produção.

4. Gerando os tokens de acesso

Para consumir qualquer recurso da API, você precisará de:

  • access_token (utilizado nas requisições à API)
  • refresh_token (utilizado para renovar seu access_token após sua expiração)

Esses tokens são obtidos através do fluxo OAuth2 usando seu client_id e client_secret. O processo de autenticação detalhado está disponível na seção Autenticação da API Conta Azul.


Próximo passo: consulte o guia completo sobre o fluxo OAuth2 e autenticação para começar a realizar suas primeiras chamadas à API Conta Azul.