Meilleures pratiques

Lignes directrices pour créer des intégrations fiables avec DiffHook.

Utilisez des sélecteurs CSS pour réduire le bruit

Les pages changent constamment : les bannières de cookies sont mises à jour, les publicités sont actualisées, les horodatages sont cochés. Adaptez vos moniteurs au contenu qui vous intéresse réellement :

{
  "css_selector": "#pricing-table"
}

Cela réduit les faux positifs et rend vos différences plus significatives.

Utiliser le rendu JS uniquement en cas de besoin

Le rendu du navigateur sans tête est plus lent et plus gourmand en ressources. Activez-le uniquement lorsque la page cible nécessite réellement JavaScript pour afficher un contenu significatif.

La plupart des flux d'actualités, des sites de documentation et des pages de tarification sont rendus par le serveur et n'en ont pas besoin.

Répondez rapidement aux webhooks

Votre point de terminaison doit renvoyer 200 OK dans un délai de 10 secondes. Les délais d'attente et les réponses non-2xx déclenchent des tentatives automatiques avec un intervalle exponentiel en minutes (voir Réception de webhooks).

Traitez les charges utiles de manière asynchrone : transférez-les vers une file d'attente, enregistrez-les dans une base de données, puis renvoyez immédiatement 200.

Idempotence

Les webhooks peuvent être livrés plusieurs fois dans de rares scénarios d'échec. Utilisez la combinaison monitor_id + triggered_at comme clé de déduplication :

const eventKey = `${body.monitor_id}:${body.triggered_at}`
if (await redis.get(eventKey)) return // Already processed
await redis.set(eventKey, '1', 'EX', 86400)

Choisissez le bon intervalle

Une bonne règle de base :

Cas d'utilisation	Intervalle recommandé
Ventes flash, alertes prix	5 à 15 minutes
Surveillance des concurrents	60 minutes
Dépôts réglementaires	360 minutes (6h)
Sites d'emploi, pages carrière	1440 min (quotidiennement)

Vérifier les signatures

Vérifiez toujours l’en-tête X-Signature avant de traiter les charges utiles du webhook. Cela protège contre les demandes usurpées. Consultez le guide Vérifier les signatures pour des exemples de mise en œuvre.