Per a socis i compradors

Webhook

En una frase

Un webhook és un missatge que el sistema d'un proveïdor envia a una adreça web que tu proporciones tan bon punt canvia alguna cosa. En diagnòstic, és com el teu producte sap que s'ha rebut una mostra o que un resultat ja és disponible.

Un webhook és un missatge que el sistema del proveïdor envia a una adreça que li indiques cada vegada que es produeix un esdeveniment definit. Sense un webhook, el teu programari ha de preguntar una vegada i una altra a l'API del proveïdor si hi ha hagut algun canvi, cosa que consumeix peticions i afegeix retard per al client. Aniva envia un webhook signat per a cada canvi d'estat de la mostra, de manera que el teu sistema rep l'avís un sol cop per canvi.

La signatura importa perquè qualsevol persona que trobi l'adreça que publiques hi pot accedir. Una signatura permet que el teu codi comprovi que un missatge ve realment del proveïdor abans que el teu producte actuï en conseqüència. Els reintents importen pel mateix motiu, perquè el teu endpoint deixarà d'estar disponible en algun moment i caldrà tornar a enviar el missatge.

  • Pregunta quins esdeveniments generen un webhook i què conté cada missatge.
  • Pregunta com se signen els missatges i on estan documentats els passos de verificació.
  • Pregunta què passa quan el teu endpoint està caigut i quants reintents es fan.
  • Pregunta si es poden tornar a enviar els esdeveniments anteriors després d'una caiguda del teu sistema.

Un webhook no elimina la necessitat de l'API, perquè el teu sistema igualment llegeix el resultat complet un cop el missatge l'avisa que n'hi ha un. Els equips que prescindeixen dels webhooks solen consultar l'API a intervals fixos, cosa que resulta més lenta per al client que espera un informe.

En aquest glossari, API REST explica la interfície que crida el teu codi, mentre que Temps fins al resultat tracta l'espera que nota el teu client i Portal de col·laboradors mostra l'opció per a un equip sense desenvolupadors.

Aquesta entrada del glossari és informació general, no consell mèdic, i no té com a objectiu diagnosticar, tractar ni descartar cap afecció. Comenta els teus resultats amb un professional sanitari que conegui el teu historial.

El teu jo futur t'espera

Comença a construir la dècada més saludable de la teva vida.

Comença