0006. Cliente HTTP propio con ApiError y adminRequest¶
Estado: Aceptado
Fecha: 2026-10-21
Autor: Duval Alcivar
Módulo(s) afectado(s): panel administrativo (core-admin): capa HTTP compartida
Evidencia: commit 3b81172 (2026-10-21) y src/shared/http (request, adminRequest, ApiError)
Contexto¶
Todas las vistas llaman a la misma API y necesitan mostrar el mensaje de error
del backend tal cual. Sin una capa común, cada vista repetiría la composición de
la URL, el Content-Type y la traducción del error a un mensaje.
Decisión¶
request<T>() compone ${VITE_API_BASE_URL}/api/v1${path}, fuerza JSON y
normaliza cualquier fallo a ApiError(status, detail), usando el detail del
backend como mensaje. adminRequest<T>() añade el header
Authorization: Bearer <token> y rechaza localmente si no hay token, sin
llegar a la red.
Alternativas descartadas¶
- Axios con interceptores — no hay evidencia de su uso en el repositorio y
fetchcubre el caso con menos dependencias.
Consecuencias¶
La base de la API y el prefijo /api/v1 viven en un solo lugar, y el error de
backend llega intacto a la UI. Como no hay interceptor global, un 401 no cierra
la sesión ni redirige: cada llamada decide qué hacer con el fallo.
Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).