Access Tokens
Gerencie os tokens de acesso do Asaas para diferentes clientes
Endpoints
GET
/api/access-tokens
Lista todos os tokens de acesso cadastrados.
Resposta
[
{
"id": "string",
"clientId": "string",
"accessToken": "string",
"description": "string",
"isActive": boolean,
"createdAt": "string",
"updatedAt": "string"
}
]
POST
/api/access-tokens
Cria um novo token de acesso.
Request Body
{
"clientId": "string", // Identificador único do cliente
"accessToken": "string", // Token de acesso do Asaas
"description": "string" // Descrição opcional
}
Exemplo
curl -X POST "http://seu-servidor/api/access-tokens" \
-H "Content-Type: application/json" \
-d '{
"clientId": "cliente_123",
"accessToken": "seu_token_asaas",
"description": "Token para ambiente de produção"
}'
GET
/api/access-tokens/:id
Obtém detalhes de um token específico.
Exemplo
curl -X GET "http://seu-servidor/api/access-tokens/123"
GET
/api/access-tokens/client/:clientId
Busca um token ativo pelo ID do cliente.
Exemplo
curl -X GET "http://seu-servidor/api/access-tokens/client/cliente_123"
PATCH
/api/access-tokens/:id
Atualiza um token existente.
Request Body
{
"accessToken": "string", // Opcional
"description": "string", // Opcional
"isActive": boolean // Opcional
}
Exemplo
curl -X PATCH "http://seu-servidor/api/access-tokens/123" \
-H "Content-Type: application/json" \
-d '{
"description": "Token atualizado",
"isActive": true
}'
DELETE
/api/access-tokens/:id
Remove um token de acesso.
Exemplo
curl -X DELETE "http://seu-servidor/api/access-tokens/123"
PATCH
/api/access-tokens/:id/activate
Ativa um token de acesso.
Exemplo
curl -X PATCH "http://seu-servidor/api/access-tokens/123/activate"
PATCH
/api/access-tokens/:id/deactivate
Desativa um token de acesso.
Exemplo
curl -X PATCH "http://seu-servidor/api/access-tokens/123/deactivate"
Gerenciamento de Tokens
Você também pode gerenciar os tokens através da interface administrativa em /admin.
A interface oferece uma forma mais amigável de visualizar, criar, editar e remover tokens.
Boas Práticas
- Mantenha um token diferente para cada cliente
- Use descrições claras para identificar o propósito de cada token
- Desative tokens que não estão mais em uso
- Nunca compartilhe tokens entre ambientes (Sandbox/Produção)
- Monitore regularmente os tokens ativos