Auth Token

Gera um token JWT para autenticação nas demais requisições da API.

Endpoint

POST /api/v2/external/auth-token

Headers

Header	Valor	Obrigatório
Content-Type	application/json	Sim

Request Body

Campo	Tipo	Obrigatório	Descrição
client_id	string	Sim	Identificador da API Key
client_secret	string	Sim	Secret da API Key

{
  "client_id": "sua-api-key-id",
  "client_secret": "sua-api-key-secret"
}

Exemplo

curl -X POST https://api.owem.com.br/api/v2/external/auth-token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "sua-api-key-id",
    "client_secret": "sua-api-key-secret"
  }'

Resposta 200

{
  "worked": true,
  "access_token": "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Campo	Tipo	Descrição
worked	boolean	Indica sucesso da operação
access_token	string	Token JWT para uso nos headers
token_type	string	Sempre Bearer
expires_in	integer	Validade em segundos (3600 = 60 minutos)

Resposta 401

{
  "worked": false,
  "detail": "Credenciais inválidas"
}

Uso do Token

Inclua o token no header Authorization de todas as requisições subsequentes:

Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9...

Validade

O token expira em 60 minutos. Implemente renovação automática antes da expiração.