Pour les partenaires et acheteurs

Webhook

En une phrase

Un webhook est un message que le système d'un fournisseur envoie à une adresse web que tu fournis, dès que quelque chose change. Dans le diagnostic, c'est ainsi que ton produit est informé qu'un échantillon a été reçu ou qu'un résultat est prêt.

Un webhook est un message que le système du fournisseur envoie à une adresse que tu lui indiques chaque fois qu'un événement défini se produit. Sans lui, ton logiciel doit interroger sans cesse l'API du fournisseur pour savoir si quelque chose a changé, ce qui consomme des requêtes et ajoute du délai pour le client. Aniva envoie un webhook signé à chaque changement de statut d'un échantillon, de sorte que ton système est informé une seule fois par changement.

La signature compte parce que l'adresse que tu publies est accessible à quiconque la trouve. Une signature permet à ton code de vérifier qu'un message vient bien du fournisseur avant que ton produit n'agisse. Les nouvelles tentatives comptent pour la même raison, car ton endpoint sera indisponible à un moment donné et le message devra être renvoyé.

  • Demande quels événements produisent un webhook et ce que contient chaque message.
  • Demande comment les messages sont signés et où les étapes de vérification sont documentées.
  • Demande ce qui se passe lorsque ton endpoint est indisponible et combien de nouvelles tentatives suivent.
  • Demande si les événements passés peuvent être renvoyés après une panne de ton côté.

Un webhook ne supprime pas le besoin de l'API, car ton système lit toujours le résultat complet une fois que le message lui indique qu'il existe. Les équipes qui n'utilisent pas de webhooks interrogent plutôt l'API à intervalles fixes, ce qui est plus lent pour le client qui attend un rapport.

Dans ce glossaire, REST API couvre l'interface que ton code appelle, tandis que Time-to-Result couvre l'attente que ton client remarque et Partner-Portal couvre l'accès pour une équipe sans développeurs.

Cette entrée de glossaire est une information générale, pas un avis médical, et elle ne vise pas à diagnostiquer, traiter ou écarter une maladie. Parle de tes propres résultats à un professionnel de santé qui connaît tes antécédents.

Ton futur toi t'attend

Commence à construire la décennie la plus saine de ta vie.

Commencer