Autenticação (OAuth2 Client Credentials)¶

Todas as APIs da AI Hub usam autenticação OAuth2 com client_credentials.

URL para obter o token¶

https://accounts.knewin.com/realms/knewin/protocol/openid-connect/token

Endpoint¶

POST https://accounts.knewin.com/realms/knewin/protocol/openid-connect/token

Obtenha um token de acesso.

• Content-Type: application/x-www-form-urlencoded
• Grant type:
• grant_type=client_credentials
• Credenciais do client:
• client_id=<CLIENT_ID>
• client_secret=<CLIENT_SECRET>

Exemplo cURL¶

curl --location 'https://accounts.knewin.com/realms/knewin/protocol/openid-connect/token' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'client_id=<CLIENT_ID>' \
  --data-urlencode 'client_secret=<CLIENT_SECRET>'

Exemplo de resposta¶

{
  "access_token": "<JWT>",
  "expires_in": 300,
  "token_type": "Bearer"
}

Uso do token nas requisições¶

O JWT retornado em access_token deve ser enviado nas chamadas da API no header Authorization:

Authorization: Bearer <ACCESS_TOKEN>

access_token é temporário e expira conforme o campo expires_in (em segundos). Recomendação: reutilize o token enquanto válido e solicite um novo token antes da expiração para evitar respostas 401 Unauthorized.