REST-API

Eine REST-API ist eine Reihe von Webadressen, die ein Anbieter bereitstellt, damit deine Software eine Anfrage senden und eine strukturierte Antwort erhalten kann. Dein System authentifiziert sich, sendet eine Anfrage wie etwa die Bestellung eines Tests und liest die Antwort im Code. Die Aniva API nutzt einen API-Key-Header, einen Idempotency-Header für sichere Wiederholungen sowie eine Sandbox mit Testdaten. Die Dokumentation findest du unter docs.anivahealth.com.

Die Schnittstelle ist bei einer Bewertung wichtig, weil sie bestimmt, wie viel Arbeit deine Entwickler einmalig leisten müssen und wie oft dein Betriebsteam manuelle Schritte täglich wiederholt. Eine Sandbox ermöglicht es deinen Entwicklern, die Schnittstelle vor Vertragsabschluss auszuprobieren. Das ist der günstigste Weg herauszufinden, wie gut sie ist.

• Frage nach der Dokumentations-URL und lies sie vor dem ersten technischen Gespräch.
• Frage, ob eine Sandbox mit Testdaten vorhanden ist und wie dein Team einen Account bekommt.
• Frage, wie mit wiederholten Anfragen umgegangen wird, da eine Bestellung niemals zwei Proben erzeugen darf.
• Frage, wie eine Fehlermeldung aussieht, wenn eine Bestellung abgelehnt wird.
• Frage, wie du über Änderungen an der Schnittstelle informiert wirst und wie lange ältere Versionen noch funktionieren.

Eine Integration ist nicht der einzige Weg für den Start, denn Aniva bietet auch eine Partnerkonsole, in der dein Team ohne Programmieraufwand arbeiten kann. Viele Partner nutzen beides: die API im eigenen Produkt und die Konsole für das Support-Team.

In diesem Glossar erklärt Webhook, wie Statusänderungen dein System erreichen, während Partner-Portal den Weg für Teams ohne Entwickler beschreibt und FHIR den Standard abdeckt, den institutionelle Käufer möglicherweise fordern.