# 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.

> **Atenção:** Mesmo com o acesso facilitado, é crucial consultar os passos **“Fazendo Chamadas à API com o Access Token”** e **“Renovando seu Access Token (Essencial para Acesso Contínuo)”**. Eles são indispensáveis para garantir que sua integração seja completa e funcione sem interrupções!


## 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](https://chromewebstore.google.com/detail/api-conta-azul-extension/pfakdepihdfjipjnpccdhfgepfmlfhkg?hl=pt-BR).
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](https://developers-portal.contaazul.com/#/login), 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.


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