Skip to main content

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: envelope object 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:

Manejo de errores

La API devuelve errores con el envelope:
Los campos 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.

Health checks