Dla partnerów i kupujących

Webhook

W jednym zdaniu

Webhook to wiadomość, którą system dostawcy wysyła na podany przez ciebie adres internetowy, gdy tylko coś się zmieni. W diagnostyce w ten sposób twój produkt dostaje informację, że próbka dotarła lub wynik jest gotowy.

Webhook to wiadomość, którą system dostawcy wysyła na podany przez ciebie adres za każdym razem, gdy wystąpi określone zdarzenie. Bez niego twoje oprogramowanie musi raz po raz odpytywać API dostawcy, czy coś się zmieniło, co zużywa zapytania i powoduje opóźnienia dla klienta. Aniva wysyła podpisany webhook przy każdej zmianie statusu próbki, więc twój system dostaje informację raz na każdą zmianę.

Podpisywanie ma znaczenie, ponieważ do opublikowanego przez ciebie adresu może dotrzeć każdy, kto go znajdzie. Podpis pozwala twojemu kodowi sprawdzić, czy wiadomość naprawdę pochodzi od dostawcy, zanim twój produkt na nią zareaguje. Ponawianie prób ma znaczenie z tego samego powodu, bo twój endpoint będzie w pewnym momencie niedostępny i wiadomość trzeba będzie wysłać ponownie.

  • Zapytaj, które zdarzenia generują webhook i co zawiera każda wiadomość.
  • Zapytaj, jak podpisywane są wiadomości i gdzie udokumentowano kroki weryfikacji.
  • Zapytaj, co się dzieje, gdy twój endpoint nie działa, i ile ponownych prób jest wykonywanych.
  • Zapytaj, czy wcześniejsze zdarzenia można wysłać ponownie po awarii po twojej stronie.

Webhook nie znosi potrzeby korzystania z API, bo twój system nadal odczytuje pełny wynik, gdy komunikat da mu znać, że jest już dostępny. Zespoły, które rezygnują z webhooków, zwykle odpytują API według stałego harmonogramu, co jest wolniejsze dla klienta czekającego na raport.

W tym słowniku REST API dotyczy interfejsu wywoływanego przez twój kod, Time-to-Result – czasu oczekiwania odczuwanego przez twojego klienta, a Partner-Portal – ścieżki dla zespołu bez programistów.

Ten wpis w słowniku zawiera ogólne informacje, nie jest poradą medyczną i nie służy do diagnozowania, leczenia ani wykluczania żadnych schorzeń. Omów swoje wyniki z lekarzem, który zna twoją historię.

Twoje przyszłe ja czeka

Zacznij budować najzdrowszą dekadę swojego życia.

Zacznij