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