Referência da API
Obter Tokens de Acesso
Obtenha tokens de acesso para hosts associados ao seu domínio.
Este endpoint retorna uma lista de hosts com seus respectivos tokens de acesso.
Endpoint
GET /api/externalAPIs/public/domainAccess/getAccessTokens
Base URL
Substitua {{BASE_URL}} pelo endereço do ambiente (desenvolvimento, homologação ou produção).
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
domainToken | string | Token de domínio para autenticação (obrigatório) |
Autenticação
Inclua o token de domínio no cabeçalho da requisição:
Authorization: Bearer {SEU_DOMAIN_TOKEN}
Exemplo de Requisição
curl -X GET \
'{{BASE_URL}}/api/externalAPIs/public/domainAccess/getAccessTokens' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {SEU_DOMAIN_TOKEN}'
Exemplo de Resposta
{
"code": 200,
"message": "Success",
"data": [
{
"host_id": "uuid-do-host",
"host_slug": "slug-do-host",
"created_at": "2024-03-21T00:00:00Z",
"our_token": "token-de-acesso"
}
]
}
Funcionamento
A rota getAccessTokens retorna uma lista de todos os hosts associados ao domínio autenticado, incluindo seus respectivos tokens de acesso. Esta informação é útil para gerenciar múltiplos hosts dentro de um mesmo domínio.
Códigos de Erro
403: Credenciais inválidas ou sem permissão de acesso500: Erro interno do servidor ao processar a requisição
Segurança
- Use sempre HTTPS e restrinja o acesso a esta rota no seu backend.
- Não registre tokens em logs. Mascarar ou remover antes de persistir qualquer log.
- Faça rotação periódica de tokens conforme a política do seu domínio.