Seiteninhalt:
Die Query API: PractitionerRole ermöglicht den Abruf von Daten zur Zuordnung von Leistungserbringenden zu Leistungserbringerinstitutionen im Medication Service, wie z. B. der Verbindung zwischen Ärzt:innen oder Apotheker:innen und ihren jeweiligen Praxen oder Apotheken.
Die Nachricht zum Abruf von Daten zur Zuordnung von Leistungserbringenden zu Leistungserbringerinstitutionen wird als HTTP GET-Anfrage an den Medication Service gesendet, um eine Liste der hinterlegten PractitionerRole-Instanzen abzurufen.
Wenn das ePA-Client-System eine Suche nach der Zuordnung von Leistungserbringenden zu Leistungserbringerinstitutionen durchführen und dazu die korrespondierenden PractitionerRole-Ressourcen ermitteln möchte, sendet es eine Query API: PractitionerRole-Nachricht an den Medication Service. Das ePA-Client-System verarbeitet die Antwort und bringt sie zur Anzeige.
Anfragen an die PractitionerRole-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.
Bei Anfragen an die QueryAPI für die PractitionerRole-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 PractitionerRole-Ressource oder weitere Ressourcen im Zusammenhang mit der Abfrage enthalten können.
Um spezifische Details zu einer einzelnen PractitionerRole-Instanz über die RESTful API zu erhalten, kann die PractitionerRole Instance API verwendet werden, indem eine HTTP GET-Anfrage an den Endpunkt /PractitionerRole/[id] gesendet wird.
Der Medication Service verarbeitet die Anfrage, um die PractitionerRole-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 PractitionerRole-Ressourcen zurück.
Generelle Sicherheitsanforderungen werden hier festgehalten.