Créer une surveillance

Portée `watches:write`. En-tête `Idempotency-Key` obligatoire, conservé 24 heures. Le Registre foncier n'offre pas de flux poussé. Une surveillance est une revérification planifiée, comparée à un instantané de référence pris à la création. Sans `account_id`, elle est placée sur le compte par défaut. Avec `account_id`, elle est épinglée à ce compte. Elle consomme la capacité quotidienne d'index de ce compte (plafond 540, dont 180 réservés aux appels à la demande). Créer la surveillance interroge les rôles d'évaluation foncière des municipalités du Québec, l'un des jeux de données publics intégrés aux Données Fonciq. `cadence` vaut `weekly` (défaut) ou `daily`. Créer la surveillance ne débite pas Fonciq. Chaque index consulté ensuite débite 99 cents sur une clé réelle et 150 cents au Registre, parce que l'index consulte toujours le Registre. Les frais du Registre s'appliquent lorsque le Registre est consulté. Ce débit de 99 cents n'est pas renvoyé ici. Plafond d’organisation : 25 surveillances actives. Au-delà, la réponse est `409` et le code `watch_cap_reached`. Il n’y a pas de plafond quotidien d’index de surveillance par organisation. Chaque compte garde le sien. `cadence` est `weekly` ou `daily`, pas une cadence mensuelle. La pause, la suppression, l’historique et le renvoi manuel se font dans le tableau de bord.

curl -X POST "https://api.fonciq.ca/v1/watches" \  -H "Idempotency-Key: stringst" \  -H "Content-Type: application/json" \  -d '{    "lot": "1234567",    "cadence": "weekly",    "url": "https://exemple.com/hooks/fonciq"  }'

{
  "id": "watch_01HZX",
  "lot": "1234567",
  "cadence": "weekly",
  "account_id": "rfa_exemple",
  "url": "https://exemple.com/hooks/fonciq",
  "status": "active"
}

{
  "error": {
    "code": "invalid_request",
    "message": "Indiquer une adresse ou un matricule.",
    "request_id": "req_01HZX"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Clé d'API refusée.",
    "request_id": "req_01HZX"
  }
}

{
  "error": {
    "code": "account_not_found",
    "message": "Ce compte du Registre n'appartient pas à l'organisation.",
    "request_id": "req_01HZX"
  }
}

{
  "error": {
    "code": "watch_cap_reached",
    "message": "Le plafond de surveillances actives est atteint.",
    "request_id": "req_01HZX"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Trop de requêtes pour cette clé.",
    "request_id": "req_01HZX"
  }
}