v1

latestOpenAPI 3.0.32026-07-2410639570.9 KB

Sesiones - V2

Iniciar sesión con OTP

Valida el OTP y retorna un Bearer token válido por 1 hora. El OTP en sí mismo es válido durante 1 hora desde que fue enviado. Cada inicio de sesión genera un nuevo token e invalida el anterior.

post/api/v2/sessions

Request body

phonestring required

area_codeinteger required

Código de marcación internacional del país (ej. 57 para Colombia, 52 para México). No es un código ISO alfa-2.

otpstring required

Example request

{
  "phone": "3001234567",
  "area_code": 57,
  "otp": "1234"
}

Response

tokenstring required

Token Bearer para peticiones autenticadas. Expira después de 1 hora (TOKEN_TTL). Debe enviarse en el header de autorización así: Authorization: Bearer <token>. Se genera un token nuevo en cada inicio de sesión; los tokens anteriores quedan invalidados.

Example response

{
  "token": "AbCdEf123456xYz"
}