MarkUDown
API de Monitor — documentação de monitoramento com webhook MarkUDown
POST
/api/monitorMonitor
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âmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| url | string | obrigatório | — | URL a monitorar. |
| callback_url | string | obrigatório | — | URL de webhook que recebe o aviso de mudança (POST). |
| interval_minutes | integer | opcional | 60 | De quanto em quanto tempo verificar a página, em minutos. |
| main_content | boolean | opcional | true | Compara só o conteúdo principal (ignora mudanças na navegação e no rodapé). |
| timeout | integer | opcional | 60 | Tempo 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