Aller au contenu principal
DiffHook/Documentation
Référence APIDémarrage rapide

Démarrage rapide

Faites fonctionner votre premier moniteur en moins de 2 minutes.

1. Obtenez un jeton au porteur

Connectez-vous, accédez à Paramètres → Clés API et créez une clé. Vous recevrez un ID client (la seule valeur avec le préfixe dh_live_) et un Secret client (chaîne opaque sans ce préfixe).

Échangez-les contre un jeton au porteur :

Utilisez le access_token renvoyé dans l’en-tête Authorization: Bearer <token> sur toutes les demandes. Les jetons expirent après 24 heures – voir Authentication pour le flux complet.

2. Créez un moniteur

3. Recevoir les événements de changement

Lorsque le contenu change, DiffHook POST vers l'URL dans notification_config.webhook_url pour ce moniteur, ou vers le webhook par défaut de votre espace de travail si vous n'avez pas défini de remplacement par moniteur :

{
  "event": "page.changed",
  "monitor_id": "mon_abc123",
  "url": "https://competitor.com/pricing",
  "triggered_at": "2026-03-16T14:22:00Z",
  "content": "Pro plan: $59/month — …"
}

4. Testez-le manuellement

Vous pouvez déclencher un contrôle immédiat à tout moment :

Prochaines étapes

  • Surveillance de la portée — ajoutez un css_selector pour ignorer le bruit de navigation/pied de page
  • Pause lorsque vous n'en avez pas besoin : utilisez /pause et /resume pour respecter l'utilisation du moniteur de votre forfait.
  • Vérifier les signatures : authentifier les webhooks entrants avec le secret de signature
DiffHook - Surveillance de sites web