Formato de respuesta
Toda respuesta de la API tiene exactamente tres claves raíz:
{
"success": true,
"message": "",
"data": {}
}
- success —
truesi la operación se completó,falsesi hubo un error. - message — texto listo para mostrar al usuario. En errores explica qué pasó.
- data — siempre un objeto. Las entidades viajan aplanadas en el primer nivel, relacionadas por ID.
Convenciones de los datos
- Todas las claves viajan en camelCase, tanto en el request como en la respuesta.
- Las fechas viajan en ISO-8601 UTC con sufijo
Z:2026-04-21T14:30:00.000Z. - El dinero viaja en centavos enteros (
amountCents), nunca en decimales. - Los booleanos pueden llegar como
1o0. - Los códigos técnicos (statuses, tipos) van en inglés; los textos visibles, en español.
Errores
Los errores de negocio y de validación responden HTTP 400 con success: false. Una sesión inválida o vencida responde HTTP 401.