API REST · tailjnx
API REST del ERP Sistemas Educativos — backend multi-institucional con tailjnx.
Esta URL no es la aplicación web. Estás en el dominio del API backend. La interfaz de usuario (login, módulos, tablas) vive en el frontend Angular. Si buscas el sistema, abre la URL del cliente asignada por tu institución.
Prefijo de todos los recursos REST
Respuesta esperada: pong
Framework interno: tailjnx
Multi-empresa — cada petición debe indicar la institución activa con el header
x-company.
Códigos configurados: UEE, UELE, UERF, UERE
| Header | Uso |
|---|---|
x-company |
Código de institución (UEE, UELE, UERF, UERE) |
x-database-mode |
Opcional en lecturas: default · selected · all |
Cookie: access_token |
Sesión JWT (httpOnly) — rutas protegidas, withCredentials: true |
Las entidades se generan con npx tailjnx generate:entities.
Cada archivo *.routes.ts se monta en
/api/v1/{nombre} (nombre del archivo sin extensión).
En un proyecto recién creado aún no hay CRUDs — solo rutas del framework (health y schema).
| Método | Ruta relativa | Descripción |
|---|---|---|
| GET | / |
Listado paginado (jConfigQuery) |
| GET | /count |
Conteo con los mismos filtros |
| GET | /:id |
Detalle por ID |
| POST | / |
Crear registro |
| PUT | /:id |
Actualizar registro |
| DELETE | /:id |
Eliminar registro |
| PATCH | /toggle/:id |
Alternar estado (si el modelo lo soporta) |
| POST | /bulk |
Creación masiva |
Ejemplo: user.routes.ts →
GET /api/v1/user,
GET /api/v1/user/:id, etc.
Puedes añadir rutas personalizadas en el mismo router antes del bloque CRUD generado.
Health check del servidor (tailjnx): GET /api/v1/auth/ping
— no confundir con rutas de entidades generadas después.