🔑 Gerando Credenciais de API
Para gerar as credenciais de integração com a nossa API, siga os passos abaixo:
- Acesse o portal da sua conta.
- No menu lateral, clique em Configurações.
- Em seguida, acesse a seção Integrações.
- Clique na opção API, conforme mostrado na imagem abaixo.
- Na tela de Chaves de API clique no botão Gerar novo token.
- Na tela Gerar Token informe um título para facilitar a identificação do token e caso seja necessário informe uma data de expiração (opcional).
Expiração
Caso uma data de expiração seja configurada, o token deixará de ser válido ao atingir essa data.
Nessa situação, será necessário gerar um novo token e atualizar suas integrações para evitar falhas de autenticação.
Tipo de autenticação
Após gerar suas credenciais, você deve realizar a autenticação e enviar o token de acesso no cabeçalho (header) de cada requisição à API.
🧩 Exemplo de uso do Bearer Token
Abaixo, um exemplo de requisição utilizando o Bearer Token no cabeçalho:
curl -X GET https://api.bempaggo.com/v1/invoices \
-H "Authorization: Bearer SEU_TOKEN_DE_ACESSO" \
-H "Content-Type: application/json"Importante
Substitua SEU_TOKEN_DE_ACESSO pelo token gerado no portal.
O prefixo Bearer deve sempre preceder o token, separado por um espaço.
NÃO COMPARTILHE
A sua chave da API é SECRETA e não deve ser compartilhada com terceiros.