Livraison et nouvelles tentatives

Répondre en moins de 10 secondes

Votre récepteur doit renvoyer un code HTTP 2xx en moins de 10 secondes. Tout autre code, dépassement de délai ou erreur réseau compte comme une tentative échouée et entraîne une nouvelle tentative. Le corps de votre réponse n’est pas interprété.

Doublons et ordre d’arrivée

Les livraisons sont asynchrones et peuvent arriver dans le désordre. Les nouvelles tentatives gardent le même id : utilisez-le comme clé de déduplication. Pour vos données métier, utilisez reservationId, customerId, vehicleId ou callRecordId comme identifiant stable selon l’événement. repair.status_changed utilise reservationId. Ne supposez pas que createdAt représente l’ordre des modifications métier.

Désactivation

Une réponse 410 Gone désactive définitivement l’abonnement sans nouvelle tentative. Créez un nouvel abonnement pour reprendre. Dix échecs consécutifs provoquent aussi une désactivation et une notification dans le tableau de bord. Une livraison réussie remet le compteur d’échecs à zéro.

Destinations autorisées

Seules les adresses HTTPS publiques sont autorisées. Les adresses locales, privées, link-local et les noms d’hôte sans domaine sont refusés lors de l’inscription et à chaque tentative de livraison. Une destination interdite entraîne une désactivation sans nouvelle tentative.

Diagnostiquer un problème

Consultez GET /webhooks pour lire status, consecutiveFailures, lastDeliveredAt et lastError. Vérifiez la disponibilité HTTPS du récepteur, le délai de réponse et le secret utilisé. Ne journalisez pas vos clés ou secrets.