Gera um access_token

POST

/api/v1/auth/token

Troca um par client_id / client_secret por um access_token JWT.

O token retornado deve ser enviado no header Authorization: Bearer <token>
nas demais chamadas da API Pública. O tempo de vida do token é definido no
campo expires_in (em segundos) — solicite um novo após expirar.

Erros comuns

Código	Causa
`invalid_request`	Body malformado ou campos obrigatórios ausentes
`invalid_client`	`client_id` inexistente ou `client_secret` incorreto
`server_error`	Falha temporária — repita com backoff

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

Authorization: ********************

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200OK

application/json

Token gerado com sucesso.

Bodyapplication/json

🟠400Requisição Inválida

🟠401Não Autorizado

🔴500Erro do Servidor

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://gtw.unnotech.com.br/public/api/v1/auth/token' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "client_id": "minha-empresa-prod",
    "client_secret": "S3cr3t0Ult4Secret0"
}'

Response Example

200 - Sucesso

Sucesso

{
    "access_token": "eyJhbGciOiJSUzI1NiIs...",
    "token_type": "Bearer",
    "expires_in": 3600,
    "scope": "internal"
}

Modificado em 2026-08-18 04:28:10

Página anterior

Changelog e avisos de mudança

Próxima página

Busca applications pelo id externo do consumidor

Gera um access_token

Erros comuns#

Requisição

Respostas

Erros comuns