Outils développeurs
Recevez des événements, pilotez la sandbox et découvrez ce qui s'est réellement passé.
Les outils pour recevoir des événements, joindre votre ordinateur depuis Wajub, produire n'importe quel résultat à la demande et voir ce qu'a réellement fait votre intégration.
Le chemin le plus court vers une intégration fonctionnelle
- 1
Découvrez les informations reçues, puis écrivez le handler
Vérifiez la signature, répondez avec un code
2xx, puis placez le traitement dans une file. Vous trouverez l'enveloppe, le catalogue et cinq handlers fonctionnels dans Webhooks. - 2
Recevez un événement réel sur votre ordinateur
wajub listen --forward-to localhost:3000/webhooks/wajub. Aucun tunnel, aucun déploiement, et la signature est réelle. L'installation nécessite une seule commande, présentée dans CLI. - 3
Produisez les résultats nécessaires
wajub trigger payment.failed, puis le remboursement, puis l'expiration. Lorsqu'un résultat ne peut pas être déclenché par la CLI, un numéro de test le force. - 4
Consultez le résultat
Konsole conserve la requête, l'événement et chaque tentative de livraison, avec le corps renvoyé par votre endpoint.
Les deux commandes qui remplacent la majeure partie d'un environnement de test
wajub listen et wajub trigger, dans deux terminaux, créent une boucle complète d'événements
sans déploiement ni téléphone. Tous les autres outils présentés ici accompagnent ces deux commandes.
Limites de chaque outil
Chaque partie de la boucle possède une limite. Chacune a déjà fait perdre une journée à quelqu'un.
| Apparence | Réalité |
|---|---|
| Un abonnement à tout couvre tous les événements | Un abonnement * ignore les livraisons du cycle de vie Sync |
| La CLI peut produire tous les événements | Elle en déclenche huit. Les quarante-neuf autres sont produits en manipulant la ressource |
| Le bouton Envoyer un test de Konsole prouve que votre handler fonctionne | Il prouve l'URL, la signature et l'enveloppe. Son event vaut webhook.test et son data est un exemple : le code qui traite un vrai type d'événement ne s'exécute jamais |
| Un canal fonctionnel dans la sandbox fonctionne en live | La sandbox accepte tous les opérateurs pour lesquels elle a des numéros de test. En live, seuls les canaux que votre compte peut débiter sont proposés |
| Konsole affiche toutes les décisions de routage | Le routage existe uniquement en live. Rien n'est visible dans la sandbox |
Choisir selon le symptôme
| Symptôme | Point de départ |
|---|---|
| Je ne connais pas les événements disponibles | Catalogue des événements |
| La vérification de ma signature échoue toujours | Vérification de signature |
| Mon endpoint n'est pas accessible depuis Internet | wajub listen |
| J'ai immédiatement besoin d'un paiement échoué | wajub trigger |
| L'API a renvoyé une réponse que je ne comprends pas | Logs API |
| L'événement a été émis, mais mon handler ne s'est jamais exécuté | Livraisons de webhooks |
| Le paiement a utilisé le mauvais prestataire | Routage |
| Je veux que mon agent écrive correctement l'intégration | Skills pour agents |