Catégories

Debogueur et relais webhook

Genere une URL unique de capture webhook, inspecte les requetes, valide les signatures et rejoue les payloads vers une cible

Exemples de résultats

2 Exemples

Capturer des webhooks Stripe avant relais

Cree une URL unique, valide la signature et rejoue les requetes selectionnees

Webhook dashboard with a unique capture URL, signature validation, and replay controls.
Voir paramètres d'entrée
{ "relayTargetUrl": "https://api.example.com/webhooks/stripe", "signatureSecret": "whsec_test_123", "signatureHeader": "stripe-signature", "autoReplay": false, "methodFilter": "POST", "bodyMustContain": "\"type\":\"invoice.paid\"", "storedRequestLimit": 50 }

Debugger des payloads GitHub avec relais conditionnel

Ne transfere automatiquement que les push correspondants et conserve un log complet

Webhook dashboard configured for conditional relay, replay, and export.
Voir paramètres d'entrée
{ "relayTargetUrl": "https://api.example.com/webhooks/github", "signatureSecret": "github_secret_value", "signatureHeader": "x-hub-signature-256", "autoReplay": true, "methodFilter": "POST", "bodyMustContain": "\"ref\":\"refs/heads/main\"", "storedRequestLimit": 100 }

Points clés

Catégorie
Network
Types d’entrée
text, checkbox, select, number
Type de sortie
html
Couverture des échantillons
4
API disponible
Yes

Vue d’ensemble

Ce débogueur et relais webhook vous permet de générer une URL de capture unique pour inspecter, valider et rejouer vos requêtes HTTP. Idéal pour le développement d'API, il facilite l'analyse des payloads entrants, la vérification des signatures HMAC et le transfert conditionnel des données vers vos environnements locaux ou de production.

Quand l’utiliser

  • Lors du développement et du test d'intégrations d'API tierces comme Stripe, GitHub ou Shopify.
  • Pour inspecter le contenu exact des payloads webhook avant de les traiter dans votre application.
  • Pour rejouer des requêtes échouées vers un environnement local sans avoir à déclencher à nouveau l'événement source.

Comment ça marche

  • Générez une URL de capture unique et configurez-la comme point de terminaison dans le service tiers.
  • Définissez des règles de filtrage (méthode HTTP, contenu du corps) et configurez la validation de signature si nécessaire.
  • Inspectez les requêtes entrantes dans le tableau de bord en temps réel.
  • Rejouez manuellement ou automatiquement les requêtes correspondantes vers votre URL cible.

Cas d’usage

Débogage des événements de paiement Stripe en environnement de test.
Relais des événements de push GitHub vers un serveur d'intégration continue local.
Validation des signatures HMAC pour sécuriser les points de terminaison d'API publics.

Exemples

1. Capturer et déboguer des webhooks Stripe

Développeur Backend
Contexte
L'intégration des paiements nécessite de tester la réception des événements Stripe en local.
Problème
Il est difficile de voir le payload exact envoyé par Stripe et de tester le code local sans exposer le serveur de développement.
Comment l’utiliser
Générez l'URL de capture, définissez le filtre sur POST et exigez que le corps contienne l'événement de paiement.
Configuration d’exemple
{
  "relayTargetUrl": "https://api.example.com/webhooks/stripe",
  "signatureSecret": "whsec_test_123",
  "signatureHeader": "stripe-signature",
  "methodFilter": "POST",
  "bodyMustContain": "\"type\":\"invoice.paid\""
}
Résultat
Les événements de paiement sont capturés, la signature est validée, et les requêtes peuvent être inspectées avant d'être rejouées vers l'API locale.

2. Relais conditionnel des payloads GitHub

Ingénieur DevOps
Contexte
Un pipeline CI/CD doit être déclenché uniquement lors d'un push sur la branche principale.
Problème
GitHub envoie de nombreux événements, ce qui encombre les logs du serveur CI local et déclenche des builds inutiles.
Comment l’utiliser
Configurez l'outil pour rejouer automatiquement les requêtes POST contenant la référence à la branche principale.
Configuration d’exemple
{
  "relayTargetUrl": "https://ci.example.com/github-webhook",
  "autoReplay": true,
  "methodFilter": "POST",
  "bodyMustContain": "\"ref\":\"refs/heads/main\""
}
Résultat
Seuls les pushs sur la branche principale sont automatiquement transférés au serveur CI, réduisant ainsi le bruit et facilitant le débogage.

Tester avec des échantillons

network

Hubs associés

FAQ

Comment valider la signature d'un webhook ?

Renseignez le secret de signature et le nom de l'en-tête (ex: stripe-signature). L'outil vérifiera automatiquement l'authenticité de la requête entrante.

Puis-je rejouer automatiquement les requêtes ?

Oui, en activant l'option 'Rejouer automatiquement les requêtes correspondantes' et en définissant une URL cible de replay.

Combien de requêtes puis-je stocker ?

Vous pouvez configurer la limite de requêtes stockées entre 10 et 200 via l'option correspondante.

Est-il possible de filtrer les webhooks reçus ?

Absolument. Vous pouvez filtrer par méthode HTTP (POST, PUT, PATCH) et exiger qu'une chaîne spécifique soit présente dans le corps de la requête.

Quels types de webhooks sont pris en charge ?

L'outil prend en charge n'importe quel webhook HTTP standard, y compris ceux de Stripe, GitHub, Slack ou de vos propres applications.

Documentation de l'API

Point de terminaison de la requête

POST /fr/api/tools/webhook-debugger-relay

Paramètres de la requête

Nom du paramètre Type Requis Description
relayTargetUrl text Non -
signatureSecret text Non -
signatureHeader text Non -
autoReplay checkbox Non -
methodFilter select Non -
bodyMustContain text Non -
storedRequestLimit number Non -

Format de réponse

{
  "result": "
Processed HTML content
", "error": "Error message (optional)", "message": "Notification message (optional)", "metadata": { "key": "value" } }
HTML: HTML

Documentation de MCP

Ajoutez cet outil à votre configuration de serveur MCP:

{
  "mcpServers": {
    "elysiatools-webhook-debugger-relay": {
      "name": "webhook-debugger-relay",
      "description": "Genere une URL unique de capture webhook, inspecte les requetes, valide les signatures et rejoue les payloads vers une cible",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=webhook-debugger-relay",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Vous pouvez chaîner plusieurs outils, par ex.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 outils.

Si vous rencontrez des problèmes, veuillez nous contacter à [email protected]