MarkUDown

API de Monitor — documentación de monitoreo con webhook MarkUDown

POST/api/monitor

Monitor

Crea un monitor persistente que revisa una página periódicamente y envía un webhook (POST) cada vez que el contenido cambia. Cada suscripción se ejecuta en segundo plano de forma independiente hasta que se cancela.

ParámetroTipoRequeridoPor defectoDescripción
urlstringrequerido—URL a monitorear.
callback_urlstringrequerido—URL de webhook que recibe el aviso de cambio (POST).
interval_minutesintegeropcional60Cada cuánto revisar la página, en minutos.
main_contentbooleanopcionaltrueCompara solo el contenido principal (ignora cambios en la navegación y el pie de página).
timeoutintegeropcional60Tiempo límite de carga de la página, en segundos.

Solicitud

{
  "url": "https://books.toscrape.com/",
  "callback_url": "https://your-server.com/webhook",
  "interval_minutes": 30,
  "main_content": true
}

Respuesta

// POST /api/monitor — creates subscription
{
  "success": true,
  "subscription_id": "a1b2c3d4-...",
  "url": "https://books.toscrape.com/",
  "interval_minutes": 30,
  "callback_url": "https://your-server.com/webhook"
}

// Webhook payload on change:
{
  "event": "change_detected",
  "subscription_id": "a1b2c3d4-...",
  "url": "https://books.toscrape.com/",
  "changed": true,
  "current_hash": "def456...",
  "previous_hash": "abc123...",
  "checked_at": "2026-04-22T14:30:00Z"
}

// GET /api/monitor — list active subscriptions
// DELETE /api/monitor/{subscription_id} — cancel