Saltar a contenido

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 fetch cubre 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).