NouveauComment le protocole Agent Session Protocol etablit la confiance entre systemes autonomes.
Cas d'usage

Livraison fiable de webhooks

Envoyez une fois, livrez a chaque terminal avec tentatives et preuve.

Vous envoyez un webhook.

Le terminal est en panne.

Vous reessayez une fois. Deux fois.

Toujours en panne.

L'evenement est perdu.

Votre client ouvre un ticket.

npayload reessaie, recupere et prouve la livraison.

Aucun evenement n'est jamais perdu.

Visualisez le flux

Livraison garantie

Six tentatives avec delai progressif exponentiel. Disjoncteur pour les echecs persistants. File de messages non delivres pour tout ce qui echoue encore.

Delivery Attempts
1
POST /webhook
503
retry
+0s
2
POST /webhook
503
retry
+2s
3
POST /webhook
503
retry
+8s
4
POST /webhook
200
delivered
+32s
Exponential backoff. Never lost.

Preuve de livraison

Horodatages, codes de reponse et historique des tentatives pour chaque livraison. Vos clients peuvent tout verifier.

Delivery Proof
api.acme.com/hooks200
sha256=a3f8...14:22:08
events.partner.io200
sha256=7e2b...14:22:09
hooks.client.dev200
sha256=b91c...14:22:09

Verification de signature

Chaque webhook est signe. Les destinataires verifient l'authenticite sans effort supplementaire.

Delivery Proof
api.acme.com/hooks200
sha256=a3f8...14:22:08
events.partner.io200
sha256=7e2b...14:22:09
hooks.client.dev200
sha256=b91c...14:22:09

Terminaux independants

Un terminal lent n'affecte pas les autres. Chaque livraison est suivie et retentee independamment.

Billing API42ms
Shipping Service38ms
Analytics51ms
Notification Hub29ms

Comment ca fonctionne

1

Enregistrez vos terminaux

Indiquez a npayload ou livrer. Definissez les preferences de tentatives et les seuils d'echec.

2

Les evenements sont livres avec preuve

Chaque livraison est signee et suivie. Les codes de reponse et l'historique des tentatives sont enregistres.

3

Les echecs se retablissent d'eux memes

Tentatives avec delai progressif. Disjoncteur pour les echecs persistants. File de messages non delivres pour tout ce qui echoue encore.

Avant et apres npayload pour la livraison de webhooks

Sans npayload

  • Les webhooks echouent sans que personne ne le sache
  • Les reprises sont codees a la main avec une logique fragile
  • Impossible de prouver qu'un webhook a ete livre ou non
  • Les endpoints lents ralentissent toute la file de livraison
  • La verification de signature est implementee differemment par chaque equipe

Avec npayload

  • Chaque webhook est suivi de la publication a la reception confirmee
  • Les reprises exponentielles et la DLQ sont gerees automatiquement
  • Les rapports de reception fournissent une preuve cryptographique de livraison
  • Les disjoncteurs isolent les endpoints lents sans bloquer les autres
  • La verification HMAC est standardisee et geree cote infrastructure

npayload vs construire soi meme

FonctionnalitenpayloadConstruction maison
ReprisesBackoff exponentiel configurable avec plafondBoucle de retry maison avec risque de surcharge
DisjoncteurCoupe automatiquement les endpoints defaillantsAucune protection, les erreurs s'accumulent
Preuve de livraisonRapport de reception avec horodatage et signatureLog serveur sans valeur juridique
DLQFile de lettres mortes avec inspection et rejeuLes evenements echoues disparaissent silencieusement
Verification de signatureHMAC standardise verifie cote edge (Cloudflare)Implementation variable par equipe, souvent absente
ObservabiliteTrace distribuee W3C de bout en boutLogs fragmentes sans correlation

Questions frequentes

Combien de reprises npayload effectue t il par defaut ?+
Le nombre de reprises et les intervalles sont configurables par canal. Par defaut, npayload utilise un backoff exponentiel avec jitter. Apres epuisement des tentatives, l'evenement est route vers la DLQ pour inspection et rejeu manuel.
Comment fonctionne le disjoncteur ?+
Quand un endpoint accumule les erreurs 5xx, le disjoncteur s'ouvre et cesse les appels pour eviter la surcharge. Il se referme automatiquement apres une periode de repos et reprend les livraisons.
Est ce que npayload peut remplacer notre systeme de webhooks existant ?+
Oui. Vous publiez vos evenements sur npayload et les destinataires recoivent des webhooks signes avec reprises, disjoncteurs et preuves de livraison. La migration peut se faire graduellement, canal par canal.
Comment les destinataires verifient ils l'authenticite des webhooks ?+
Chaque webhook est signe avec HMAC. Les destinataires verifient la signature avec la cle partagee. npayload fournit des SDK qui simplifient la verification en une ligne de code.