API
Webhooks
Recevez des notifications en temps réel sur les événements de vos expéditions.
Webhooks
Concept
Les webhooks envoient des requêtes HTTP POST à votre serveur lorsque des événements se produisent dans Swaloo. C'est le moyen le plus efficace de synchroniser vos systèmes.
Configurer un webhook
- Rendez-vous dans Paramètres > API > Webhooks
- Cliquez sur Nouveau webhook
- Saisissez l'URL de destination (
https://) - Sélectionnez les événements à écouter
- Enregistrez
Événements disponibles
| Événement | Déclencheur |
|---|---|
shipment.created | Nouvelle expédition créée |
shipment.status_changed | Changement de statut |
shipment.delivered | Expédition livrée |
shipment.failed | Échec de livraison |
driver.location_updated | Position du chauffeur mise à jour |
route.completed | Tournée terminée |
Format du payload
{
"event": "shipment.status_changed",
"timestamp": "2024-03-15T14:30:00Z",
"data": {
"id": "shp_abc123",
"status": "in_transit",
"previous_status": "pending"
}
}Sécurité
Chaque requête inclut un header X-Webhook-Signature contenant un HMAC-SHA256 du body. Vérifiez cette signature avec votre secret webhook.
Tentatives
En cas d'échec (réponse non-2xx), Swaloo retente :
- 1 minute après
- 5 minutes après
- 30 minutes après
- 2 heures après
- 24 heures après
Après 5 échecs consécutifs, le webhook est désactivé automatiquement.
Votre endpoint doit répondre dans les 10 secondes avec un code 2xx.