REST-API

Eine REST-API ist eine Sammlung von Webadressen, die ein Anbieter veröffentlicht, damit deine Software eine Anfrage stellen und eine strukturierte Antwort erhalten kann. Dein System authentifiziert sich, sendet eine Anfrage – zum Beispiel eine Bestellung für ein Panel – und liest die Antwort als Code aus. Die „ Aniva “-API nutzt einen API-Schlüssel-Header, einen Idempotenz-Header für sichere Wiederholungsversuche und eine Sandbox mit Testdaten; die Dokumentation findest du unter docs.anivahealth.com.

Die Benutzeroberfläche spielt bei einer Bewertung eine wichtige Rolle, denn sie entscheidet darüber, wie viel Arbeit eure Entwickler einmalig erledigen müssen und wie viel euer Betriebsteam jeden Tag manuell wiederholen muss. Mit einer Sandbox können eure Entwickler die Benutzeroberfläche schon vor Vertragsunterzeichnung ausprobieren – das ist der kostengünstigste Weg, um herauszufinden, wie gut sie ist.

• Frag nach dem Link zur Dokumentation und lies sie dir vor dem ersten technischen Gespräch durch.
• Frag nach, ob es eine Sandbox mit Testdaten gibt und wie dein Team einen Zugang bekommt.
• Frag nach, wie mit wiederholten Anfragen umgegangen wird, denn aus einer Bestellung dürfen niemals zwei Muster entstehen.
• Frag nach, was eine Fehlermeldung enthält, wenn eine Bestellung abgelehnt wird.
• Frag nach, wie du über Änderungen an der Benutzeroberfläche informiert wirst und wie lange ältere Versionen noch funktionieren.

Eine Integration ist nicht die einzige Möglichkeit, loszulegen, denn Aniva bietet auch eine Partnerkonsole, mit der dein Team arbeiten kann, ohne Code schreiben zu müssen. Viele Partner nutzen beides: die API in ihrem eigenen Produkt und die Konsole für das Support-Team.

In diesem Glossar erklärt „Webhook“, wie eine Statusänderung in dein System gelangt, während „Partner-Portal“ den Weg für ein Team ohne Entwickler beschreibt und „FHIR“ den Standard behandelt, den ein institutioneller Einkäufer möglicherweise verlangt.