Endpoint de Autenticación

POST/login

Autenticar usuario y obtener token de acceso

Objetivo

El endpoint /login permite autenticar un usuario en el sistema utilizando sus credenciales (usuario y contraseña) y obtener un token de autorización que será necesario para realizar llamadas a otros endpoints de la API.

Request

Headers

Este endpoint no tiene headers requeridos.

Body Parameters

Parámetro	Tipo	Requerido	Descripción
username	String	Sí	Nombre de usuario proporcionado para el acceso.
password	String	Sí	Contraseña del usuario.

Response

Response Body

Parámetro	Tipo	Descripción
token	String	Token de autorización para usar en futuras peticiones
expiresIn	Number	Tiempo de expiración del token en segundos
user	Object	Información del usuario autenticado
permissions	String[]	Lista de permisos del usuario

Response Examples

200 OK

401 Unauthorized

429 Too Many Requests

Consideraciones

El token debe incluirse en el header 'x-authorization-token' para futuras peticiones.
Los tokens tienen una duración limitada especificada en el campo 'expiresIn'.
Después de 5 intentos fallidos, la cuenta se bloquea temporalmente.
Se recomienda implementar un mecanismo de renovación de tokens antes de su expiración.

CLIENT LIBRARIES

REQUEST EXAMPLE

curl --request POST \
--url https://auth.homo.tapila.cloud/login \
--header 'x-authorization-token: YOUR_TOKEN_HERE' \
--header 'x-api-key: YOUR_API_KEY_HERE' \
--header 'Content-Type: application/json' \
--data '{
  "username": "demo_user",
  "password": "demo_password"
}'

Referencia API