Livraison, tentatives et idempotence des webhooks

Une réponse 2xx accuse réception d’une livraison de webhook. Une réponse non-2xx ou une erreur de transport ne l’accuse pas.

​

Recevez un webhook de façon sûre

Gardez le handler HTTP minimal. N’exécutez pas de logique métier lente, d’enrichissement ou d’appel API en aval avant d’accuser réception.

1. Lisez X-Immoteur-Event-Id et persistez ou mettez durablement l’événement en queue avant de l’accuser réception.
2. Renvoyez 204 No Content ou une autre réponse 2xx dès que ce travail est sûr.
3. Traitez l’événement dans votre propre worker ou queue après la réponse HTTP. La queue et le worker relèvent de votre architecture d’intégration, pas d’un service Immoteur.

​

Timeouts

Immoteur applique actuellement un timeout de connexion de 5 secondes et un timeout de requête de 5 secondes. Un receiver qui attend un travail lent peut expirer avant d’accuser réception. Persistez ou mettez en queue, puis renvoyez rapidement une réponse réussie.

​

Lisez les en-têtes de livraison

Ne supposez pas que les chunks d’export bénéficient de la même stabilité d’event ID que les notifications d’annonces.

​

Réessais et circuit breaker

Une réponse non-2xx, y compris une 4xx, n’est pas un accusé de réception réussi. Un export peut avoir plusieurs tentatives et chunks : ne supposez ni taille fixe ni ordre strict. Immoteur applique la politique de réessai adaptée après une livraison non accusée. Lorsque 1 000 événements en réessai sont en cours pour un service, son circuit s’ouvre pendant 10 minutes. Les livraisons de ce service sont ignorées pendant ce délai et ne sont pas rejouées automatiquement. Configurez l’endpoint et les filtres dans Configurer les webhooks Immoteur. Utilisez Synchroniser les annonces pour le flux d’intégration avec export complet, notifications en direct et export delta. Utilisez Fiabilité de l’API pour les en-têtes de limite de l’API.