Webhook on viesti, jonka toimittajan järjestelmä lähettää antamaasi osoitteeseen aina, kun määritelty tapahtuma toteutuu. Ilman webhookia ohjelmistosi joutuu kysymään toimittajan sovellusrajapinnalta yhä uudelleen, onko tilanteessa tapahtunut muutoksia, mikä kuluttaa pyyntöjä ja aiheuttaa viivettä asiakkaalle. Aniva lähettää allekirjoitetun webhookin jokaisesta näytteen tilan muutoksesta, joten järjestelmäsi saa tiedon muutoksesta vain kerran.
Allekirjoitus on tärkeää, koska kuka tahansa, joka löytää julkaisemasi osoitteen, voi ottaa siihen yhteyttä. Allekirjoituksen avulla koodisi voi tarkistaa, että viesti on todella peräisin palveluntarjoajalta, ennen kuin tuotteesi reagoi siihen. Uudelleenyrittäminen on tärkeää samasta syystä, sillä päätepisteesi voi olla jossain vaiheessa poissa käytöstä, jolloin viesti on lähetettävä uudelleen.
- Kysy, mitkä tapahtumat laukaisevat webhookin ja mitä kukin viesti sisältää.
- Kysy, miten viestit allekirjoitetaan ja missä vahvistusvaiheet on dokumentoitu.
- Kysy, mitä tapahtuu, kun päätelaitteesi on poissa käytöstä, ja kuinka monta uudelleenkokeilua tehdään.
- Kysy, voidaanko aiemmat tapahtumat lähettää uudelleen, jos teillä on ollut katkos.
Webhook ei poista API:n tarvetta, koska järjestelmäsi lukee silti koko tuloksen, kun viesti ilmoittaa sen olemassaolosta. Webhookeja käyttämättömät tiimit tekevät yleensä API-kyselyjä kiinteän aikataulun mukaan, mikä on hitaampaa raporttia odottavalle asiakkaalle.
Tässä sanastossa termi ”REST API” viittaa rajapintaan, jota koodisi kutsuu, kun taas termi ”Time-to-Result” viittaa asiakkaan havaitsemaan odotusaikaan ja termi ”Partner-Portal” viittaa prosessiin, jota tiimi, jossa ei ole kehittäjiä, käyttää.
Tämä sanastomerkintä on yleistä tietoa, ei lääketieteellistä neuvontaa, eikä sen tarkoituksena ole diagnosoida, hoitaa tai sulkea pois mitään sairautta. Keskustele omista tuloksistasi terveydenhuollon ammattilaisen kanssa, joka tuntee sairaushistoriasi.
