Como enviar requisições para a nossa API
Para autenticar com nossa API você precisa de uma chave de API. É com essa chave que nossa API identifica a sua conta e te permite enviar requisições com sucesso.
🔒 Gerenciando chaves de API
Você pode listar, criar e invalidar suas chaves de API dentro da nossa plataforma.
Chaves de API funcionam em ambientes diferentes.
Se você criar uma chave de API em dev mode, ela funcionará no ambiente de testes. Se você criar uma chave de API em produção, ela funcionará com dados reais.
Leia mais sobre dev mode aqui.
Caso a sua chave de API não seja informada no header, esteja inválida ou revogada, nossa API retornará o código HTTP 401.
🔑 Criando chaves de API
Ao criar sua chave de API, lembre-se de armazená-la em um local seguro.
- Não compartilhe suas chaves de API de forma a comprometê-las.
- Nós não pedimos as suas chaves de API.
- Você pode revogar uma chave sempre que quiser, dentro da nossa plataforma.
Para criar sua chave de API é muito fácil, basta navegar no dashboard até a seção Integrar:
Clique no botão "Criar" e em seguida adicione um descrição sobre a sua chave. Esse campo serve para você identificar a sua chave, então tenha criatividade 😄.
Com sua chave criada, encontre-a na lista e clique em "Copiar chave".
Pronto, agora é só guardar a sua chave em um lugar seguro e começar a integrar.
🚀 Enviando requisições
Após criar sua conta e obter sua chave de API, você pode utilizar a seguinte URL para integrar:
https://api.abacatepay.com/v1
Temos somente um URL base para nossa API
Todos os tokens interagem com a mesma API então certifique-se de utilizar os tokens de dev mode e produção da forma correta.
Envie sempre os seguintes cabeçalhos na sua requisição HTTP:
"Authorization": "Bearer <seu token>"