G01: Abruf einer Liste mit allen DiGA des DiGA-Verzeichnisses
Beschreibung
Dieser grundlegende Anwendungsfall beschreibt den Abruf einer Liste mit allen digitalen Gesundheitsanwendungen (DiGA), die im DiGA-Verzeichnis gelistet sind.
Beteiligte Akteure
- Alle Nutzerinnen / Nutzer der DiGA-API
Auslöser
- Nutzerin / Nutzer der DiGA-API möchte eine Liste mit allen verfügbaren DiGA abrufen und darstellen
Standardablauf
- Nutzerin / Nutzer der DiGA-API fragt eine Liste mit allen Einträgen des DiGA-Verzeichnisses an
- DiGA-API liefert die angefragte DiGA-Liste zurück
- Nutzerin / Nutzer stellt die DiGA-Liste im individuellen Nutzungskontext dar
API-Abfrage
GET https://diga.bfarm.de/api/fhir/v2.0/DeviceDefinition?_profile=https://fhir.bfarm.de/StructureDefinition/HealthApp
Das zurückgelieferte Searchset ist FHIR-üblich paginiert. Im Element meta.total ist die Gesamtzahl der Ergebnisse über alle Seiten sichtbar. Der FHIR®-Server benutzt standardmäßig eine Seitengröße von 20 Elementen. Das bedeutet der Aufruf liefert nur die erste Seite der Ergebnisse (20 DiGA).
Die weiteren Seiten sind über das link-Element verlinkt. Durch Angabe des _count-Parameters lässt sich die Anzahl der Ergebnisse je Seite einstellen.
Auf externen System darf die zurückgelieferte id der DeviceDefinition-Ressource sowie aller weiterer Ressourcen nicht gespeichert werden. Stattdessen dürfen auf externen System nur die in den Ressourcen hinterlegten identifier gespeichert werden.