- Gratuit
- Sans inscription
- Expire dans 24h
Testeur de Webhook / Callback
Obtenez une URL temporaire, pointez un callback vers elle et inspectez les corps reçus et les en-têtes conservés. Conçu pour déboguer les callbacks de tâches asynchrones HiAPI. Les corps POST de plus de 64 Kio renvoient 413 et ne sont jamais stockés ni tronqués ; les cookies, les en-têtes d'IP transférée/client et de secret d'entrée ne sont pas conservés.
Quiconque possède cette URL peut lire ce qui arrive ici, et tout est supprimé à son expiration. Ne l'utilisez pas pour le trafic de production ou les données sensibles.
Envoie une charge utile d'exemple à votre adresse depuis ce navigateur, pour que vous puissiez voir l'outil fonctionner avant de configurer un vrai callback.
Réponse que l'expéditeur reçoit
Modifiez ceci pour tester les nouvelles tentatives : renvoyez un statut non-2xx et HiAPI réessaiera le callback, pour que vous puissiez observer le calendrier dans la liste.
Requêtes
En attente de la première requête…
Pointez votre callback vers l'URL ci-dessus, ou envoyez une requête de test pour voir à quoi cela ressemble.
Détail de la requête
Sélectionnez une requête pour voir ses en-têtes et son corps.
Créer une tâche avec ce callback
Copiez ceci, remplacez la clé et le modèle, et exécutez-le.
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.0",
"callback": { "url": "https://www.hiapi.ai/tools/webhook-tester/hook/YOUR_TOKEN", "when": "final" },
"input": { "prompt": "a cyan glass data center entrance", "duration": 5, "resolution": "720p" }
}'How to test a webhook in three steps
Copiez votre URL temporaire
Ouvrez cette page et copiez l'adresse qu'elle vous donne. Elle reste active pendant 24 heures et accepte les POST de n'importe quelle source.
Pointez votre callback vers elle
Passez-la comme callback.url lorsque vous créez une tâche asynchrone, ou utilisez le bouton « Envoyer une requête de test » pour en lancer une immédiatement.
Lisez la requête
Les requêtes apparaissent dès leur arrivée. Inspectez les en-têtes, le corps et le type de contenu ; collez votre clé de signature de webhook pour vérifier la signature localement.
What this tool cannot do
- Il compare uniquement la cohérence HMAC HiAPI, pas la fraîcheur ni la protection contre la relecture, et une correspondance seule ne peut pas prouver l'origine. Sans clé de signature, un callback ressemble à n'importe quel autre POST.
- Les corps de plus de 64 Kio renvoient 413 et ne sont jamais stockés ni tronqués. Les cookies, les en-têtes d'IP transférée/client et de secret d'entrée ne sont pas conservés.
- La relecture n'est pas une requête originale exacte. Les en-têtes sont supprimés et les règles CORS, de contenu mixte ou de réseau local peuvent la bloquer ; l'accès à localhost n'est pas garanti.
- Il ne peut pas rechercher des tâches. Il ne reçoit que des charges utiles, il n'a donc pas accès à l'état des tâches, au solde ou aux artefacts.
- Ce n'est pas un stockage permanent. L'adresse et son contenu sont détruits après 24 heures, n'envoyez donc pas de données de production ou sensibles.
- L'URL est un identifiant. Quiconque la possède peut lire ce qui arrive.
- Une cible localhost ne reçoit jamais un vrai callback HiAPI, car HiAPI doit l'atteindre via l'internet public.
Webhook tester FAQ
À quoi sert un testeur de webhook ?
Un testeur de webhook vous donne une adresse qui accepte les requêtes HTTP entrantes et affiche les en-têtes conservés et le corps. Les cookies, les en-têtes d'IP transférée/client et de secret d'entrée sont supprimés. Les corps de plus de 64 Kio renvoient 413 et ne sont jamais stockés ni tronqués. Cela vous évite de devoir monter un serveur juste pour inspecter un callback.
Comment tester un callback HiAPI ?
Créez une tâche sur l'API HiAPI et passez l'URL de cette page comme callback.url. Lorsque la tâche atteint un état terminal, HiAPI POST le résultat ici et la requête apparaît dans la liste.
Pourquoi le callback n'arrive-t-il pas lorsque je teste localement contre HiAPI ?
Un callback doit être accessible depuis l'internet public. Votre propre machine ne l'est généralement pas, donc une adresse localhost ne recevra jamais un vrai callback HiAPI. Utilisez une URL sur un hôte public — cette page vous en donne une.
Puis-je vérifier qu'un callback provient vraiment de HiAPI ?
Avec une clé de signature de webhook, cet outil recalcule HMAC-SHA256 sur le corps conservé et X-HiAPI-Timestamp et compare X-HiAPI-Signature localement. Une correspondance montre la cohérence avec cette clé, pas la fraîcheur ni la protection contre la relecture. Sans clé de signature, il n'y a pas de signature à comparer.
Ma clé de signature de webhook est-elle envoyée à votre serveur ?
Non. La clé n'est utilisée que dans l'API crypto de votre navigateur pour recalculer la signature. Elle n'est jamais transmise, stockée ni journalisée, et la requête qui atteint notre serveur ne la contient pas.
Combien de temps dure l'adresse et qu'arrive-t-il aux données ?
L'adresse et tout ce qu'elle a reçu sont supprimés après 24 heures. Chaque adresse conserve jusqu'à 50 requêtes. Traitez l'URL comme un identifiant : quiconque la possède peut lire ce qui est arrivé, ne l'utilisez donc pas pour la production ou des données sensibles.
Peut-il me dire à quelle fréquence HiAPI réessaie un callback échoué ?
Oui, et c'est la raison pour laquelle le statut de réponse est configurable. Réglez la réponse sur 400 ou 500, déclenchez une vraie tâche, et les heures d'arrivée dans la liste vous montrent le calendrier de nouvelles tentatives. Les nouvelles tentatives ont lieu immédiatement, puis à +1, +5 et +20 minutes, quatre tentatives au total.
Puis-je rejouer une requête ?
La relecture effectue une requête au mieux depuis votre navigateur, pas une copie exacte. Les cookies, l'autorisation, les en-têtes de proxy/plateforme et contrôlés par le navigateur ne sont pas transmis, et les redirections sont rejetées. La cible doit autoriser CORS ; le contenu mixte HTTPS vers HTTP et les règles de réseau local du navigateur peuvent la bloquer. Localhost peut fonctionner mais n'est pas garanti. Une réponse bloquée ne prouve pas que la cible n'a rien reçu.