Guías›Creando monitores

Creando monitores

Los monitores son el recurso principal de DiffHook. Cada monitor observa una URL y activa eventos cuando cambia el contenido.

Campos obligatorios

Campo	Tipo	Descripción
`label`	cadena	Nombre corto para el monitor
`url`	cadena	La URL para monitorear

interval_minutes: Con qué frecuencia se debe verificar (opcional; se aplican los valores predeterminados). Los valores válidos incluyen 5, 15, 30, 60, 360, 1440 (minutos).

notification_config: objeto JSON opcional con anulaciones por monitor, p. { "webhook_url": "https://…", "email": "alerts@…" }. Si se omite, el webhook predeterminado del espacio de trabajo de Integraciones se utiliza para la entrega HTTP.

Campos opcionales

label: un nombre legible por humanos que se muestra en el panel. El valor predeterminado es la URL.

css_selector — Alcanza la diferencia a un elemento DOM específico. Reduce el ruido de las barras de navegación, los carteles de cookies y otros textos repetitivos.

{
  "css_selector": "#pricing-table"
}

js_rendering: utiliza un navegador Chromium sin cabeza para representar la página antes de tomar una instantánea. Requerido para aplicaciones React/Vue/Angular que representan contenido del lado del cliente. Más lento y requiere más recursos: habilítelo solo cuando la página realmente requiera JavaScript para mostrar su contenido.

Selector JSON para API JSON

Los monitores de API JSON pueden establecer diferencias en un campo o lista específicos configurando json_selector.

Formularios de selector admitidos:

$ → objeto raíz
$.field → un campo en la raíz
$.a.b.c → campo anidado
$.items[*] → campo de matriz ([*] es opcional y se trata como la propia matriz)

Utilice identity_key cuando su selector se resuelva en una matriz de objetos. Esto clasifica los elementos por una clave estable antes de realizar diferencias, lo que evita diferencias ruidosas de solo reordenamiento.

{
  "json_selector": "$.items",
  "identity_key": "id",
  "track_additions_only": true
}

Ejemplo: monitorear una página de precios

Ejemplo de solicitud interactiva (de la especificación OpenAPI: cambiar de idioma, copiar o Pruébalo):

Actualizar un monitor

Puede actualizar cualquier campo mutable con una solicitud PUT. Sólo cambian los campos proporcionados:

Pausar un monitor

Al pausar un monitor, se detiene el sondeo. Los monitores en pausa no cuentan para ningún límite del plan: ni el recuento de monitores ni el presupuesto de verificación mensual. Esto hace que pausar sea la herramienta adecuada siempre que desee detener temporalmente un monitor sin perder su configuración ni liberar una ranura permanente.

Escenarios útiles: ventanas de mantenimiento, flujos de trabajo estacionales o cuando está cerca de su presupuesto de verificación y desea liberar capacidad sin eliminar un monitor.

Reanudar un monitor

La reanudación reactiva un monitor en pausa. DiffHook valida los límites del plan en el momento de la reanudación: si la reanudación lo llevaría a superar el recuento de monitores activos, el presupuesto de verificación mensual o el presupuesto de verificación de procesamiento JS, la solicitud se rechaza con un 403. Actualice su plan o ponga en pausa otro monitor primero.