Para parceiros e compradores

Webhook

Numa frase

Um webhook é uma mensagem que o sistema de um fornecedor envia para um endereço web que indicas, assim que algo muda. No diagnóstico, é assim que o teu produto fica a saber que uma amostra foi recebida ou que um resultado está pronto.

Um webhook é uma mensagem que o sistema do fornecedor envia para um endereço que lhe indicas sempre que ocorre um evento definido. Sem ele, o teu software tem de perguntar repetidamente à API do fornecedor se algo mudou, o que consome pedidos e acrescenta atraso para o cliente. A Aniva envia um webhook assinado a cada alteração de estado da amostra, para que o teu sistema seja notificado uma vez por alteração.

A assinatura importa porque o endereço que publicas pode ser acedido por qualquer pessoa que o encontre. Uma assinatura permite ao teu código verificar que uma mensagem veio mesmo do fornecedor antes de o teu produto atuar com base nela. As novas tentativas importam pelo mesmo motivo, porque o teu endpoint vai estar indisponível em algum momento e a mensagem tem de ser enviada de novo.

  • Pergunta que eventos geram um webhook e o que cada mensagem contém.
  • Pergunta como as mensagens são assinadas e onde estão documentados os passos de verificação.
  • Pergunta o que acontece quando o teu endpoint está em baixo e quantas novas tentativas se seguem.
  • Pergunta se eventos passados podem ser reenviados após uma falha do teu lado.

Um webhook não elimina a necessidade da API, porque o teu sistema continua a ler o resultado completo assim que a mensagem indica que este existe. As equipas que dispensam webhooks costumam consultar a API em intervalos fixos, o que é mais lento para o cliente que espera pelo relatório.

Neste glossário, REST API abrange a interface que o teu código chama, enquanto Time-to-Result abrange a espera que o teu cliente nota e Partner-Portal abrange a opção para uma equipa sem programadores.

Esta entrada do glossário é informação geral, não aconselhamento médico, e não se destina a diagnosticar, tratar ou excluir qualquer condição. Discute os teus próprios resultados com um profissional de saúde que conheça o teu historial.

O teu eu futuro está à espera

Começa a construir a década mais saudável da tua vida.

Começar