Aller au contenu principal
DiffHook/Documentation
Référence APIPrésentation de la référence API

Présentation de la référence API

L'API REST DiffHook vous permet de créer et de gérer par programme des moniteurs et d'interroger les journaux de livraison.

URL de base

https://www.diffhook.com

Authentification

Toutes les demandes nécessitent un jeton au porteur :

Authorization: Bearer JWTXYZ

Type de contenu

Incluez toujours Content-Type: application/json dans les requêtes POST et PUT.

Types de ressources

Moniteurs : la ressource principale. Un moniteur représente une URL surveillée, ainsi que sa configuration (intervalle, destination, sélecteur).

Journaux : enregistrements immuables des livraisons de webhooks. Créé automatiquement lorsqu'un changement est détecté.

Horodatages

Tous les horodatages sont au format ISO 8601 en UTC :

2026-03-16T14:22:00Z

Pagination

Les points de terminaison de liste renvoient jusqu’à 50 éléments par défaut. Utilisez le paramètre de requête limit pour demander jusqu'à 200.

Codes d'état HTTP

CodesSignification
200D'accord
201Créé
204Aucun contenu (suppression réussie)
400Requête incorrecte : vérifier le corps de la demande
401Non autorisé : vérifiez la clé API
403Interdit — limite atteinte
404Pas trouvé
429Tarif limité — ralentissez
500Erreur de serveur — contacter l'assistance
DiffHook - Surveillance de sites web