Para socios y compradores

Webhook

En una frase

Un webhook es un mensaje que el sistema de un proveedor envía a una dirección web que tú indicas en cuanto cambia algo. En diagnóstico es la forma de avisar a tu producto de que se ha recibido una muestra o de que un resultado está listo.

Un webhook es un mensaje que el sistema del proveedor envía a una dirección que le indicas cada vez que ocurre un evento definido. Sin él, tu software tiene que preguntar una y otra vez a la API del proveedor si algo ha cambiado, lo que consume solicitudes y añade retraso para el cliente. Aniva envía un webhook firmado en cada cambio de estado de la muestra, así que tu sistema recibe un aviso por cada cambio.

La firma importa porque cualquiera que encuentre la dirección que publicas puede acceder a ella. Una firma permite a tu código comprobar que un mensaje procede realmente del proveedor antes de que tu producto actúe en consecuencia. Los reintentos importan por el mismo motivo, porque en algún momento tu endpoint no estará disponible y habrá que volver a enviar el mensaje.

  • Pregunta qué eventos generan un webhook y qué contiene cada mensaje.
  • Pregunta cómo se firman los mensajes y dónde están documentados los pasos de verificación.
  • Pregunta qué ocurre cuando tu endpoint está caído y cuántos reintentos se realizan.
  • Pregunta si se pueden volver a enviar los eventos pasados tras una caída en tu sistema.

Un webhook no elimina la necesidad de la API, porque tu sistema sigue leyendo el resultado completo una vez que el mensaje le indica que hay uno disponible. Los equipos que prescinden de los webhooks suelen consultar la API en intervalos fijos, lo que es más lento para el cliente que espera un informe.

En este glosario, REST API cubre la interfaz a la que llama tu código, mientras que Time-to-Result cubre la espera que nota tu cliente y Partner-Portal cubre la opción para un equipo sin desarrolladores.

Esta entrada del glosario es información general, no consejo médico, y no tiene como fin diagnosticar, tratar ni descartar ninguna afección. Comenta tus propios resultados con un profesional sanitario que conozca tu historial.

Tu yo del futuro te espera

Empieza a construir la década más saludable de tu vida.

Empezar