Documentación técnica · v1
Consultar Pulso desde otra web
La misma API REST que alimenta el panel entrega JSON a otras aplicaciones. Cada respuesta incluye la hora de generación y cada lectura conserva su propia fecha.
Primera consulta
Abre el resumen público o prueba la lista de webs de la Facultad desde el navegador de otra aplicación.
const url = 'https://pulso.guzmo.es/api.php?r=webs';
const respuesta = await fetch(url);
if (!respuesta.ok) throw new Error('Pulso no disponible');
const { data, meta } = await respuesta.json();
for (const web of data) {
console.log(web.name, web.status, web.checked_at);
}Recursos públicos
Puedes utilizar la ruta versionada api.php/v1/hora o la forma api.php?r=hora.
| Petición GET | Contenido |
|---|---|
| panel | Hasta cien noticias destacadas, cinco webs, catálogo de servicios y estado de las fuentes. |
| mundial · noticias | Noticias mundiales destacadas o boletines recogidos. Filtra por tecnologia=windows. |
| webs | Resultado, latencia, contenido esperado y fecha de la última comprobación desde TIC. |
| servicios | Filtra por scope (España, Mundial o Facultad), category, status o id. Telecable usa el identificador telecable. |
| fuentes | Procedencia, última consulta y última lectura correcta por fuente. |
| historial | Transiciones de estado por tipo=web o tipo=servicio e id. Las métricas y señales privadas requieren clave. |
| hora | utc_ms, estado NTP, fuente, fecha de sincronización, zona y margen estimado si se conoce. |
| comprobador | Convierte un nombre de dominio en un enlace de comprobación externa. Usa el parámetro dominio. |
mundial, noticias, webs, servicios e historial aceptan offset y limit de 1 a 500. Continúa con meta.next_offset hasta recibir null. Los identificadores permiten relacionar lecturas y consultar su historial.
Datos con credenciales
Crea una clave de lectura para cada aplicación consumidora. Envía la cabecera Authorization: Bearer CLAVE desde su backend a través de HTTPS. El acceso privado del panel usa una clave en memoria durante la pestaña abierta.
| Recurso | Permiso y respuesta |
|---|---|
| GET privado · revision | Lectura. Panel completo de seguimiento propio o huella ligera de cambios. El panel privado visible consulta esta huella cada tres segundos. |
| GET avisos | Lectura. Coincidencias de las tecnologías seleccionadas y correcciones críticas de equipos con inventario reciente. Usa id y revision para deduplicar notificaciones. |
| GET servidores · inventario · actualizaciones | Lectura. CPU, memoria, discos, antigüedad, versiones y paquetes candidatos. Cada actualización identifica host y fuente. |
| GET servicios-privados · latido | Lectura. Estado del tenant Microsoft, señales licenciadas y últimas observaciones de sedes conectadas. |
| GET historial | Lectura. Usa tipo=metrica e id=TIC, o tipo=tenant con el identificador de la señal privada. |
| GET / PUT seleccion | Lectura para ver el catálogo. Edición para guardar {"watch":["windows","moodle"]} con Content-Type: application/json. La selección se comparte entre los consumidores. |
| POST telemetria · latido | Clave de agente o de latido vinculada al identificador del equipo. El agente incluido utiliza este contrato. |
const r = await fetch('https://pulso.guzmo.es/api.php?r=avisos', {
headers: { Authorization: 'Bearer ' + process.env.PULSO_READ_KEY }
});
if (!r.ok) throw new Error('Pulso HTTP ' + r.status);
const { data: avisos } = await r.json();Interpretar una lectura
ok refleja una comprobación satisfactoria. warning, down y maintenance indican degradación, fallo o mantenimiento. reports identifica notificaciones de usuarios. unknown indica evidencia insuficiente y stale una lectura antigua. Un enlace con link_only=true permite consultar directamente al proveedor.
El monitor consulta webs y estados cada minuto y los boletines cada cinco. La ficha de fuente permite comprobar si el proveedor respondió. El reloj usa UTC y el navegador calcula su diferencia con el servidor. Un valor null indica que falta esa medida.
Los errores se entregan en error.status y error.message. Una clave ausente o inválida devuelve 401. Los permisos u orígenes denegados devuelven 403. Una observación anterior a la almacenada devuelve 409.