Skip to content
Last updated

Guia da Extensão Conta Azul para Desenvolvedores

Bem-vindo ao guia da API Conta Azul Extension! Esta ferramenta foi criada para simplificar drasticamente o processo de autenticação e autorização OAuth 2.0, permitindo que você obtenha tokens de acesso para desenvolvimento de forma rápida e segura, diretamente do seu navegador.

Visão Geral

A integração com a API da Conta Azul utiliza o fluxo de autorização OAuth 2.0. Durante o desenvolvimento, a geração e renovação manual de tokens pode ser um processo repetitivo. A extensão para Chrome API Conta Azul Extension automatiza a captura do authorization_code e a troca pelo access_token e refresh_token, permitindo que você foque no desenvolvimento da sua aplicação.

Pré-requisitos

Antes de começar, é essencial que você tenha:

  1. Uma conta no Portal do Desenvolvedor da Conta Azul.
  2. Uma aplicação criada em "Meus Aplicativos".
  3. A URL de Redirecionamento (Callback URL) configurada corretamente.

⚠️ Importante

A URL de Redirecionamento (Callback URL) da sua aplicação no Portal do Desenvolvedor deve ser configurada exatamente como:

https://pfakdepihdfjipjnpccdhfgepfmlfhkg.chromiumapp.org/ (você pode copiar diretamente da extensão)

A extensão depende desta URL específica para interceptar o fluxo de autorização e capturar os tokens.

Passo a Passo: Gerando seu Token

O processo completo leva menos de um minuto. Siga os passos abaixo.

Passo 1: Instale a Extensão

  1. Acesse a página oficial na Chrome Web Store: API Conta Azul Extension.
  2. Clique em "Usar no Chrome" e confirme a instalação.
extension.png

ℹ️ Dica Após instalar, recomendamos fixar a extensão na barra de ferramentas do seu navegador para facilitar o acesso.

Passo 2: Configure o Client ID e Client Secret

  1. No Portal do Desenvolvedor, acesse "Minhas aplicações" e selecione sua aplicação.
  2. Copie o Client ID e o Client Secret da sua aplicação .
  3. Clique no ícone da extensão na barra de ferramentas do Chrome.
  4. Cole o Client ID e o Client Secret no campo correspondente e clique em "Entrar com Conta Azul".
  5. Uma nova aba será aberta com a tela de login da Conta Azul. Insira suas credenciais, caso necessário.

Passo 3: Gere e Autorize o Token

  1. Com o Client ID salvo, clique no botão "Gerar Tokens".
  2. Pronto! A extensão irá capturar os tokens automaticamente e exibi-los em sua interface.

O Resultado

A extensão exibirá os tokens gerados, prontos para serem usados. Copie o access_token ou o refresh_token para a sua aplicação.

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "def50200f49a6b8344a4d7072986c78a...",
  "expires_in": 3600
}