Bêta privée. Watch est appelable dès aujourd'hui avec votre clé d'API habituelle sur tout forfait payant, et les watchers ne coûtent aucune op ; le forfait gratuit Founding ne peut pas en créer. Ce n'est ni annoncé ni disponible de façon générale : les formes de requête et de réponse peuvent changer sans préavis, et il n'y a aucun engagement de stabilité ni de support, donc ne construisez rien de critique dessus pour l'instant. La feuille de route est sur
Bientôt disponible, et chaque publication est annoncée dans
le changelog.
`POST /v2/watch` est une API de détection de changements de site : vous
enregistrez une page une fois, et un planificateur local au droplet la
re-génère à une cadence fixe dans un véritable Chrome headless, compare
chaque capture à la précédente, et vous notifie par webhook signé HMAC,
par email, ou par les deux, quand la page change réellement. Cela
remplacera le cron job, la logique de diff et l'alerting que vous
devriez sinon mettre en place autour de
[l'endpoint perceive](/fr/docs/endpoints/perceive.md) : un seul enregistrement au
lieu d'un planificateur, d'un bucket de stockage et d'un script de
comparaison.
Voici l'appel minimal utile. Envoyez une URL et récupérez un watcher
programmé pour vérifier toutes les heures :
```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 réponse est l'enregistrement complet du watcher. Il est `active`
immédiatement, et `next_check_at` est réglé sur le prochain passage du
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
}
```
---
## Endpoints
| Méthode | Chemin | Objectif |
|--------|------|---------|
| `POST` | `/v2/watch` | Crée un watcher pour une URL. Renvoie `201`. |
| `GET` | `/v2/watch` | Liste les watchers de ce projet, du plus récent au plus ancien. |
| `GET` | `/v2/watch/{watcher_id}` | Récupère l'enregistrement complet d'un watcher. |
| `GET` | `/v2/watch/{watcher_id}/snapshots` | Liste l'historique des vérifications d'un watcher, du plus récent au plus ancien. |
| `PATCH` | `/v2/watch/{watcher_id}` | Met à jour la cadence, les paramètres de diff, ou met en pause/reprend. |
| `DELETE` | `/v2/watch/{watcher_id}` | Supprime un watcher en soft-delete (idempotent). |
**Content-Type :** `application/json` sur `POST` et `PATCH`.
---
## Authentification
Authentifiez-vous avec une clé privée dans l'en-tête `X-API-Key` pour les
appels serveur à serveur. C'est la méthode utilisée par tous les exemples
ci-dessous.
```http
X-API-Key: sk_your_private_key
```
Les clés publiques avec un token bearer JWT fonctionnent aussi, en suivant
le même flux que pour tous les autres endpoints : générez un token avec
votre clé `pk_`, puis envoyez-le en tant que `Authorization: Bearer