MarkUDown

API de Monitor — documentação de monitoramento com webhook MarkUDown

POST/api/monitor

Monitor

Cria um monitor persistente que verifica uma página periodicamente e envia um webhook (POST) sempre que o conteúdo muda. Cada assinatura roda em segundo plano, de forma independente, até ser cancelada.

ParâmetroTipoObrigatórioPadrãoDescrição
urlstringobrigatório—URL a monitorar.
callback_urlstringobrigatório—URL de webhook que recebe o aviso de mudança (POST).
interval_minutesintegeropcional60De quanto em quanto tempo verificar a página, em minutos.
main_contentbooleanopcionaltrueCompara só o conteúdo principal (ignora mudanças na navegação e no rodapé).
timeoutintegeropcional60Tempo limite de carregamento da página, em segundos.

Requisição

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

Resposta

// 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