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
| Codes | Signification |
|---|---|
| 200 | D'accord |
| 201 | Créé |
| 204 | Aucun contenu (suppression réussie) |
| 400 | Requête incorrecte : vérifier le corps de la demande |
| 401 | Non autorisé : vérifiez la clé API |
| 403 | Interdit — limite atteinte |
| 404 | Pas trouvé |
| 429 | Tarif limité — ralentissez |
| 500 | Erreur de serveur — contacter l'assistance |