Recevoir des webhooks

Point de terminaison

Utilisez une URL HTTPS publique qui répond rapidement avec un statut 2xx. Abonnez chaque webhook aux seuls événements utiles et limitez sa portée lorsque l’intégration ne concerne qu’une partie de l’espace.

Traitement

Vérifiez la signature avant de décoder le corps. L’enveloppe contient id, type, createdAt, apiVersion, workspaceId et data.object. Dédupliquez les événements avec leur identifiant evt_, puis placez le traitement métier dans votre propre file.

Après le premier échec, lien.to réessaie après 1 minute, 5 minutes, 30 minutes, 2 heures, 6 heures puis 12 heures : 7 tentatives au total sur environ 21 heures. Un webhook est désactivé après 100 échecs consécutifs ou 7 jours d’échec. Les réponses 404 et 410 provoquent sa désactivation immédiate. Une réponse 429 respecte Retry-After dans les limites de cette politique.