Seiteninhalt:
Die Query API: Medication ermöglicht den Abruf von Medikationsdaten eines Versicherten im Medication Service.
Die Nachricht zum Abruf von Medikationsdaten wird als HTTP GET-Anfrage an den Medication Service gesendet, um eine Liste der hinterlegten Medication-Instanzen abzurufen.
Wenn das ePA-Client-System eine Suche nach Medikationsdaten durchführen und dazu die korrespondierenden Medication-Ressourcen ermitteln möchte, sendet es eine Query API: Medication-Nachricht an den Medication Service.
Anfragen an die Medication-Ressource können über die RESTful API mittels HTTP GET-Anfragen durchgeführt werden. Dabei können spezifische Suchparameter genutzt werden, um die Anfragen zu verfeinern. Zum Beispiel:
?code=[code] kann nach Medikationen gesucht werden, die einem bestimmten Code entsprechen.?status=active kann genutzt werden, um nur aktive Medikationen zu suchen.Bei Anfragen an die QueryAPI für die Medication-Ressource wird die Antwort als ein FHIR Bundle des Typs searchset zurückgegeben. Dieses Bundle enthält eine Sammlung von Einträgen, die jeweils eine Instanz der Medication-Ressource oder weitere Ressourcen im Zusammenhang mit der Abfrage enthalten können.
Um spezifische Details zu einer einzelnen Medication-Instanz mittels der RESTful API zu erhalten, wird die Medication Instance API verwendet, indem eine HTTP GET-Anfrage an den Endpunkt /Medication/[id] gestellt wird.
Der Medication Service verarbeitet die Anfrage, um die _Medication-Einträge zu ermitteln, die den angegebenen Suchparametern entsprechen. Darüber hinaus gibt er einen zur Verarbeitung passenden HTTP Status Code sowie ein FHIR Bundle der passenden Medication-Ressourcen zurück.
Generelle Sicherheitsanforderungen werden hier festgehalten.