Beta privata. Watch è già chiamabile oggi con la tua normale chiave API su qualsiasi piano a pagamento, e i watcher non costano ops; il piano gratuito Founding non può crearli. Non è annunciato né disponibile in generale: le forme di richiesta e risposta possono cambiare senza preavviso e non c'è alcun impegno di stabilità o di supporto, quindi non costruirci ancora sopra nulla di critico. La roadmap è su
In arrivo, e ogni rilascio viene annunciato nel
changelog.
`POST /v2/watch` è un'API di rilevamento delle modifiche ai siti web: registri
una pagina una sola volta, e uno scheduler locale al droplet la ri-renderizza
a cadenza fissa in un vero Chrome headless, confronta ogni cattura con quella
precedente, e ti avvisa (via webhook firmato HMAC, via email o in entrambi
i modi) quando la pagina cambia davvero. Sostituirà il cron job, il diffing e
l'infrastruttura di notifica che dovresti altrimenti allestire intorno a
[l'endpoint perceive](/it/docs/endpoints/perceive.md): un solo record al posto di uno
scheduler, un bucket di storage e uno script di confronto.
Ecco la chiamata utile più semplice. Invia un URL e ricevi indietro un
watcher programmato per controllare ogni ora:
```bash
curl -X POST https://api.enconvert.com/v2/watch \
-H "X-API-Key: sk_your_private_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/pricing"
}'
```
La risposta è il record completo del watcher. È `active` immediatamente, e
`next_check_at` è impostato al prossimo tick del poller:
```json
{
"watcher_id": "wat_3f9a2c1b8e7d4a6f90b1c2d3e4f5a6b7",
"url": "https://example.com/pricing",
"status": "active",
"frequency_minutes": 60,
"diff_mode": "auto",
"track_fields": null,
"webhook_url": null,
"notify_email": true,
"consecutive_errors": 0,
"checks_count": 0,
"last_check_at": null,
"next_check_at": "2026-06-24T18:31:07Z",
"last_change_at": null,
"created_at": "2026-06-24T18:31:07Z",
"updated_at": null
}
```
---
## Endpoint
| Metodo | Percorso | Scopo |
|--------|------|---------|
| `POST` | `/v2/watch` | Crea un watcher per un URL. Restituisce `201`. |
| `GET` | `/v2/watch` | Elenca i watcher di questo progetto, dal più recente. |
| `GET` | `/v2/watch/{watcher_id}` | Recupera il record completo di un watcher. |
| `GET` | `/v2/watch/{watcher_id}/snapshots` | Elenca la cronologia dei controlli di un watcher, dal più recente. |
| `PATCH` | `/v2/watch/{watcher_id}` | Aggiorna la cadenza, le impostazioni di diff, o metti in pausa/riprendi. |
| `DELETE` | `/v2/watch/{watcher_id}` | Elimina in modo soft un watcher (idempotente). |
**Content-Type:** `application/json` su `POST` e `PATCH`.
---
## Autenticazione
Autenticati con una chiave privata nell'header `X-API-Key` per le chiamate
server-to-server. Questo è il percorso usato in tutti gli esempi seguenti.
```http
X-API-Key: sk_your_private_key
```
Funzionano anche le chiavi pubbliche con un token bearer JWT, seguendo lo
stesso flusso di ogni altro endpoint: genera un token con la tua chiave
`pk_`, poi invialo come `Authorization: Bearer