Tester votre endpoint de webhook
Safecube propose deux façons d'envoyer des webhooks d'exemple à un endpoint pour vérifier qu'il fonctionne : abonner l'endpoint à une expédition de démo, et envoyer un event d'exemple à la demande. Les deux envoient des données d'exemple, pas de vraies données de suivi, et aucune n'est facturée.
Expédition de démo
Un endpoint abonné à l'expédition de démo ZZZZ0000000 en reçoit régulièrement des events : chacun des events auxquels l'endpoint est abonné, toutes les 6 heures. L'expédition de démo est gratuite.
Ajoutez-la à l'endpoint comme n'importe quelle autre expédition, avec POST /easy-shipment-asynchronous, et sans compagnie maritime :
curl -X POST "https://api.sinay.ai/webhook/api/v1/easy-shipment-asynchronous" \
-H "API_KEY: $SAFECUBE_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"{endpoint_id}": {
"shipments": [{ "number": "ZZZZ0000000" }]
}
}'
Dans l'application web Safecube, la page des réglages des webhooks propose aussi une option pour ajouter l'expédition de démo à un webhook. La page se trouve à l'adresse https://app.safecube.ai/api/webhooks : ouvrez Developers dans la barre latérale, puis l'onglet Webhooks.
Envoyer un event d'exemple par l'API
POST /endpoint/{endpoint_id}/send-example envoie à tout moment à l'endpoint un event d'exemple du type choisi. Indiquez le type d'event dans le corps de la requête ; la page Events de webhook liste tous les types.
curl -X POST "https://api.sinay.ai/webhook/api/v1/endpoint/{endpoint_id}/send-example" \
-H "API_KEY: $SAFECUBE_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{ "eventType": "shipment.any.change" }'
Envoyer un event d'exemple depuis le tableau de bord Svix
Le tableau de bord Svix envoie les mêmes events d'exemple depuis un navigateur.
- Dans l'application web Safecube, ouvrez Developers dans la barre latérale, puis l'onglet Webhooks (
https://app.safecube.ai/api/webhooks). - Sélectionnez Open Svix dashboard. Le portail Svix s'ouvre, avec un menu à gauche composé de Activity, Endpoints, Event Catalog et Logs.
- Dans Endpoints, sélectionnez l'endpoint à tester. La liste affiche l'URL de chaque endpoint avec sa description et son taux d'erreur.
- Ouvrez l'onglet Testing, choisissez un type d'event, puis sélectionnez Send example.
L'exemple contient des données d'exemple, pas de vraies données, et n'est pas facturé.
Tester sans URL publique
Pour tester les webhooks avant que votre propre URL publique soit prête, créez l'endpoint avec une URL du Svix Playground. Les events envoyés à https://play.svix.com/in/{your_url_id} se consultent dans n'importe quel navigateur à l'adresse https://play.svix.com/view/{your_url_id}. La page des réglages des webhooks de Safecube renvoie aussi vers le playground, par Use our playground, pour générer un webhook de démo.