Tools API
El backend de Vivla Tools es una API REST construida con NestJS 10 que sirve a todos los frontales (frontend, community-frontend) y a la app mobile (vivla-mobile).Configuración general
Arquitectura modular
La API se organiza en módulos NestJS independientes:Servicios externos
Convenciones de la API v1
La API v1 sigue un set consistente de convenciones en toda la superficie: envelopeobject por recurso, paginación cursor, errores estructurados, request_id correlacionable, header Idempotency-Key para retries seguros, y headers de rate limit en cada respuesta. Detalle:
- Convenciones — punto de entrada para integradores.
- Códigos de error — catálogo de
error.type/error.code. - Paginación cursor —
has_more+next_cursor. - Idempotencia — header
Idempotency-Keypara retries seguros.
Manejo de errores
La API devuelve errores con el envelope:statusCode, timestamp, path, method y message también se incluyen al top-level para no romper consumers existentes; los nuevos clientes deben leer sólo el envelope error.
Catálogo completo: Códigos de error.