Auth Token

Genera un token JWT para autenticacion en las demas solicitudes de la API.

Endpoint

POST /api/v2/external/auth-token

Encabezados

Encabezado	Valor	Obligatorio
Content-Type	application/json	Si

Request Body

Campo	Tipo	Obligatorio	Descripcion
client_id	string	Si	Identificador de la API Key
client_secret	string	Si	Clave secreta de la API Key

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

Ejemplo

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

Respuesta 200

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

Campo	Tipo	Descripcion
worked	boolean	Indica exito de la operacion
access_token	string	Token JWT para uso en los encabezados
token_type	string	Siempre Bearer
expires_in	integer	Validez en segundos (3600 = 60 minutos)

Respuesta 401

{
  "worked": false,
  "detail": "Credenciales invalidas"
}

Uso del Token

Incluya el token en el encabezado Authorization de todas las solicitudes subsiguientes:

Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9...

Validez

El token expira en 60 minutos. Implemente renovacion automatica antes de la expiracion.