api.php
Enrutador principal de la API (Front ../../backend/controladores).
cambiado a api/v2/. Se mantiene el archivo en caso de fallos
Único punto de entrada para todas las peticiones AJAX del frontend. Convención de cuerpo:
- Todos los endpoints son POST.
- El cliente especifica
action. - Para endpoints que operan sobre BDs tracking, debe enviar: pagina_id : id de la página origen de la petición conexion_ids: JSON con la lista de conexion_ids elegidos (uno solo para escrituras, varios para lecturas)
Table of Contents
Functions
- jsonResponse() : never
- requireAuthApi() : void
- Valida sesión activa + binding IP/UA.
- requirePermisos() : array{paginaId: int, conexionIds: int[]}
- Valida que el usuario tiene permiso para una página sobre TODAS las conexiones recibidas. Aborta con 403 si falla.
Functions
jsonResponse()
jsonResponse(mixed $data[, int $status = 200 ]) : never
Parameters
- $data : mixed
- $status : int = 200
Return values
neverrequireAuthApi()
Valida sesión activa + binding IP/UA.
requireAuthApi() : void
Aborta con 401 si no supera la comprobación.
Renombrada respecto a auth_guard::requireAuthPage para diferenciar:
- requireAuthApi() → endpoints (este archivo) → responde JSON 401
- requireAuthPage() → páginas .php → redirige a login
requirePermisos()
Valida que el usuario tiene permiso para una página sobre TODAS las conexiones recibidas. Aborta con 403 si falla.
requirePermisos() : array{paginaId: int, conexionIds: int[]}
Lee pagina_id y conexion_ids (JSON array) del POST.