Créer une API de webhooks robuste et sécurisée
Un prompt complet pour générer une API de webhooks production-ready avec gestion des abonnements, signatures cryptographiques, retries intelligents et observabilité.
Coller dans votre IA
Collez ce prompt dans ChatGPT, Claude ou Gemini et personnalisez les variables entre crochets.
Tu es un développeur backend senior spécialisé en architecture événementielle. Conçois une API de webhooks complète pour [TYPE_APPLICATION] en utilisant [LANGAGE_ET_FRAMEWORK].
L'API doit inclure :
-
Gestion des abonnements :
- Endpoint CRUD pour enregistrer/modifier/supprimer des webhooks
- Validation de l'URL de destination (DNS resolution, blocage des IPs privées)
- Support de filtrage par type d'événement
- Stockage des abonnements avec statut actif/inactif/suspendu
-
Dispatch des événements :
- File d'attente asynchrone pour l'envoi (Redis, RabbitMQ ou équivalent)
- Payload JSON standardisé avec : id unique, timestamp, type d'événement, données, version du schema
- Envoi concurrent avec limite de débit configurable par subscriber
-
Sécurité :
- Signature HMAC-SHA256 des payloads (header X-Webhook-Signature)
- Secret unique par abonnement, généré côté serveur
- Endpoint de vérification (challenge/response) à l'enregistrement
- Rate limiting par IP et par subscriber
- Blocage des destinations vers des réseaux internes (SSRF protection)
-
Fiabilité et retries :
- Stratégie de retry avec backoff exponentiel ([NOMBRE_RETRIES] tentatives max)
- Timeouts configurables par requête (défaut : 10 secondes)
- Circuit breaker : désactivation automatique après [SEUIL_ECHECS] échecs consécutifs
- Notification à l'admin quand un webhook est suspendu
-
Observabilité :
- Logging structuré de chaque tentative (statut HTTP, latence, erreur)
- Table d'historique des livraisons consultable via API
- Dashboard endpoint avec métriques : taux de succès, latence P50/P95/P99, webhooks actifs
-
API endpoints :
- POST /webhooks — créer un abonnement
- GET /webhooks — lister les abonnements
- GET /webhooks/:id — détail d'un abonnement
- PUT /webhooks/:id — modifier
- DELETE /webhooks/:id — supprimer
- GET /webhooks/:id/deliveries — historique des livraisons
- POST /webhooks/:id/test — envoyer un événement de test
- GET /webhooks/events — lister les types d'événements disponibles
Fournis le code complet avec : modèles de données (schéma SQL ou ORM), routes, middleware d'authentification, service de dispatch, worker de file d'attente, et tests unitaires pour les fonctions critiques (signature, retry logic, validation URL). Ajoute des commentaires expliquant les choix d'architecture.
Personnaliser ce prompt avec Léa · Assistante IA
Léa réécrit ce prompt pour ton métier et ton objectif précis — 3 questions suffisent.
Pourquoi ce prompt fonctionne
Ce prompt guide l'IA pour produire une API de webhooks de niveau production. Il couvre les six piliers essentiels : gestion des abonnements, dispatch asynchrone, sécurité, fiabilité, observabilité et design d'API REST. Chaque section est suffisamment détaillée pour éviter les implémentations superficielles. Les variables [TYPE_APPLICATION] et [LANGAGE_ET_FRAMEWORK] permettent d'adapter le résultat à votre contexte exact — qu'il s'agisse d'un SaaS en Node.js/Express, d'une marketplace en Python/FastAPI ou d'une app en Go/Gin. Les variables [NOMBRE_RETRIES] et [SEUIL_ECHECS] ajustent la politique de fiabilité selon vos contraintes. Pour de meilleurs résultats, précisez votre base de données (PostgreSQL, MySQL), votre système de file d'attente préféré, et si vous avez besoin d'une authentification spécifique (API key, OAuth, JWT). Vous pouvez aussi demander des variantes : version serverless, intégration avec un cloud provider, ou ajout de fonctionnalités comme le fan-out vers plusieurs destinations ou le replay d'événements passés.
Cas d'usage
Résultat attendu
Code source complet d'une API de webhooks avec modèles de données, routes REST, service de dispatch asynchrone, worker de retry, middleware de sécurité et tests unitaires, accompagné de commentaires sur les choix d'architecture.
Améliorez ce prompt
Passez ce prompt dans l'Optimiseur pour renforcer le contexte, les contraintes et le format attendu.
Améliore ce prompt avec l'OptimiseurCommentaires
- LéaIA
Ajoute un timestamp dans la chaîne signée (pas seulement le body) et documente la fenêtre de tolérance (5 min) côté consommateur : sinon une signature HMAC reste rejouable indéfiniment. Prévois aussi un delivery_id idempotent renvoyé en header, pour que le client déduplique les retries. Et compare les signatures avec timingSafeEqual, jamais avec ==.
Termes du glossaire
📬 Recevez de nouveaux prompts chaque semaine
Rejoignez notre newsletter et ne manquez aucun prompt.
Pour aller plus loin
Prompts similaires
Optimiser les performances d'une application React
Optimisez votre application React pour atteindre d'excellentes métriques Core Web Vitals grâce à des techniques avancées de mémorisation et code splitting.
Créer un formulaire accessible
Créer des formulaires conformes aux WCAG
Concevoir une stratégie de journalisation
Concevoir une journalisation centralisée
Implémentation des déploiements canari
Déployer des changements en toute sécurité avec un canari