Emitir token bearer
Troca clientId e clientSecret por um token bearer. Chame somente a partir do seu backend. O token vale por expiresIn segundos e carrega a organização e as permissões da credencial: todas as outras operações deduzem a organização dele.
Fluxo
Antes de chamar
- Você
Credenciais no servidor
clientId e clientSecret da sua organização
Esta chamada
POSTEmitir token bearer
/resource/auth/tokenRespostas possíveis
- 200Token emitido
Guarde data.accessToken e envie como Bearer
- 400clientId ou clientSecret ausentes
Corrija o campo indicado em errors[]; repetir igual falha de novo
- 401Credencial inválida ou revogada
Não repita em laço; confira a credencial
- 429Muitas tentativas
Aguarde e tente com espera progressiva
Depois do sucesso
- Você
Use em cada chamada
Authorization: Bearer <seu-token>
Body
clientIdstringobrigatórioTamanho
1 ≤ tamanhoclientSecretstringobrigatórioTamanho
1 ≤ tamanhoRespostas
1{
2 "error": false,
3 "message": "Token generated successfully",
4 "data": {
5 "accessToken": "<access-token>",
6 "tokenType": "Bearer",
7 "expiresIn": 1800
8 },
9 "pagination": null
10}
Campos da resposta
errorbooleanopcionalmessagestringopcionaldataobjectopcionalaccessTokenstringopcionalEnvie em `Authorization: Bearer <accessToken>`.
tokenTypestringopcionalexpiresInintegeropcionalValidade em segundos. Reemita o token antes de expirar.
paginationobjectopcionalRequisição
1curl --request POST \
2 --url 'https://api.monkeypay.app/api/v2/resource/auth/token' \
3 --header 'Content-Type: application/json' \
4 --data '{
5 "clientId": "<seu-client-id>",
6 "clientSecret": "<seu-client-secret>"
7 }'
Resposta
1{
2 "error": false,
3 "message": "Token generated successfully",
4 "data": {
5 "accessToken": "<access-token>",
6 "tokenType": "Bearer",
7 "expiresIn": 1800
8 },
9 "pagination": null
10}