Fluxo de token do usuário da aplicação
Os tokens de usuário da aplicação autorizam solicitações à API REST do Serviço da SendPulse, permitindo ações específicas nos dados da conta do usuário com base em escopos.
O token é válido por um tempo limitado. Para autorizar uma solicitação posteriormente, você precisa renovar seu token. No entanto, evite fazer solicitações frequentes para não sobrecarregar a SendPulse e correr o risco de ser bloqueado.
Veja como é o fluxo de token do usuário da aplicação:
Para obter um token de usuário da aplicação, envie uma solicitação POST para:
| https://api.sendpulse.com/oauth/access_token/market |
Parâmetros da solicitação:
client_id |
string | Chave de usuário da aplicação* |
client_secret |
string | Chave de usuário da aplicação* |
grant_type |
string | Igual a client_credentials |
*As chaves de usuário da aplicação (client_id e client_secret) são diferentes das chaves que o usuário pode encontrar nas configurações da conta. As chaves de usuário da aplicação só podem ser obtidas através do fluxo de autorização.
Exemplo de solicitação:
{
"client_id": "b2bfd8a8441294fa0171c195ada8cf56",
"client_secret": "f7064fb0bbecd392d7b3ea2e2bd77758",
"grant_type": "client_credentials"
}
Exemplo de resposta se a solicitação for bem-sucedida:
{
"token_type": "Bearer",
"expires_in": 3600,
"access_token": "eyJ0eXAiOiJKV1Q...Bv1L"
}
</preParâmetros da resposta:
token_type |
string | Tipo de token. |
expires_in |
int | O tempo do token em segundos. O padrão é 3600 (60 minutos). Sempre se baseie no valor que retornou nesse campo em vez de uma duração codificada. |
access_token |
string | Token de usuário da aplicação. |
Armazene o token de cache e reutilize-o até que expire. Não solicite um novo token a cada chamada de API.
Se a API retornar com um 401 Unauthorized, verifique os dados usados, solicite um novo token e tente novamente a chamada de API. Se a recuperação também falhar, pare de tentar e exiba uma mensagem de erro ao usuário.
Exemplo de resposta se a solicitação não for bem-sucedida:
{
"error": "invalid_client",
"error_description": "Client authentication failed",
"message": "Client authentication failed"
}
Se você recebeu um erro, verifique os dados que usou e envie a solicitação novamente.
Última Atualização: 12.11.2026
ou