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 GETContenido
panelHasta cien noticias destacadas, cinco webs, catálogo de servicios y estado de las fuentes.
mundial · noticiasNoticias mundiales destacadas o boletines recogidos. Filtra por tecnologia=windows.
websResultado, latencia, contenido esperado y fecha de la última comprobación desde TIC.
serviciosFiltra por scope (España, Mundial o Facultad), category, status o id. Telecable usa el identificador telecable.
fuentesProcedencia, última consulta y última lectura correcta por fuente.
historialTransiciones de estado por tipo=web o tipo=servicio e id. Las métricas y señales privadas requieren clave.
horautc_ms, estado NTP, fuente, fecha de sincronización, zona y margen estimado si se conoce.
comprobadorConvierte 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.

RecursoPermiso y respuesta
GET privado · revisionLectura. Panel completo de seguimiento propio o huella ligera de cambios. El panel privado visible consulta esta huella cada tres segundos.
GET avisosLectura. 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 · actualizacionesLectura. CPU, memoria, discos, antigüedad, versiones y paquetes candidatos. Cada actualización identifica host y fuente.
GET servicios-privados · latidoLectura. Estado del tenant Microsoft, señales licenciadas y últimas observaciones de sedes conectadas.
GET historialLectura. Usa tipo=metrica e id=TIC, o tipo=tenant con el identificador de la señal privada.
GET / PUT seleccionLectura 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 · latidoClave 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.