Beta privada. Watch ya se puede llamar hoy con tu clave de API habitual en cualquier plan de pago, y los watchers no consumen ops; el plan gratuito Founding no puede crearlos. No está anunciado ni disponible de forma general: las formas de la solicitud y de la respuesta pueden cambiar sin avisar, y no hay ningún compromiso de estabilidad ni de soporte, así que todavía no montes nada crítico encima. La hoja de ruta está en
Próximamente, y cada versión se anuncia en
el changelog.
`POST /v2/watch` es una API de detección de cambios en sitios web: registras
una página una sola vez, y un planificador local del droplet la vuelve a
renderizar con una cadencia fija en Chrome headless real, compara cada
captura con la anterior y te notifica (mediante webhook firmado con HMAC,
email, o ambos) cuando la página realmente cambia. Reemplazará el cron job
más el diffing más el entramado de alertas que de otro modo tendrías que
montar en torno a [el endpoint de perceive](/es/docs/endpoints/perceive.md): un solo
registro en lugar de un planificador, un bucket de almacenamiento y un
script de comparación.
Esta es la llamada mínima útil. Envía una URL y recibes de vuelta un
watcher programado para verificar cada hora:
```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 respuesta es el registro completo del watcher. Está `active` de
inmediato, y `next_check_at` se fija en el siguiente 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
}
```
---
## Endpoints
| Método | Ruta | Propósito |
|--------|------|---------|
| `POST` | `/v2/watch` | Crea un watcher para una URL. Devuelve `201`. |
| `GET` | `/v2/watch` | Lista los watchers de este proyecto, del más reciente al más antiguo. |
| `GET` | `/v2/watch/{watcher_id}` | Obtiene el registro completo de un watcher. |
| `GET` | `/v2/watch/{watcher_id}/snapshots` | Lista el historial de verificaciones de un watcher, del más reciente al más antiguo. |
| `PATCH` | `/v2/watch/{watcher_id}` | Actualiza la cadencia, la configuración de diff, o pausa/reanuda. |
| `DELETE` | `/v2/watch/{watcher_id}` | Elimina un watcher (soft-delete, idempotente). |
**Content-Type:** `application/json` en `POST` y `PATCH`.
---
## Autenticación
Autentica con una clave privada en el encabezado `X-API-Key` para llamadas
de servidor a servidor. Este es el flujo que usan todos los ejemplos a
continuación.
```http
X-API-Key: sk_your_private_key
```
Las claves públicas con un token JWT bearer también funcionan, usando el
mismo flujo que todos los demás endpoints: genera un token con tu clave
`pk_` y luego envíalo como `Authorization: Bearer