Häufige Fragen
Welchem Zweck dient die DiGA-API?
Gemäß § 21 Absatz 2 und 3 Digitale-Gesundheitsanwendungen-Verordnung (DiGAV) stellt das BfArM berechtigten Nutzern ab dem 01.01.2021 die im DiGA-Verzeichnis veröffentlichten Daten auf Antrag in maschinenlesbarer Form zur Verfügung. Diese Daten werden über eine Programmierschnittstelle (DiGA-API), welche in diesem Implementierungsleitfaden dokumentiert ist, zur Verfügung gestellt. Der Implementierungsleitfaden liefert auch erste Beschreibungen von Anwwendungsfällen für die berechtigen Nutzergruppen.
Wer ist zur Nutzung der DiGA-API berechtigt?
Gemäß § 21 Absatz 2 DiGAV sind Dritte, sofern dies für die Verwendung von elektronischen Verordnungen der Leistungen nach § 33a Absatz 1 des fünften Buches Sozialgesetzbuch (SGB V) erforderlich ist, zur Nutzung der DiGA-API berechtigt.
Darüber hinaus können gemäß § 21 Absatz 3 DiGAV folgende Berechtigte einen Zugang zur DiGA-API beantragen:
- Dritte nach § 303e Absatz 1 SGB V
- Sonstige öffentliche Stellen des Bundes, der Länder oder Gemeinden
- Gemeinnützige juristische Personen des Privatrechts
Wie wird der Antrag auf Nutzung der DiGA-API gestellt?
Um die DiGA-API nutzen zu können, müssen Sie nach § 21 Absatz 2 oder 3 DiGAV berechtigt sein und im ersten Schritt einen Antrag auf Nutzung stellen. Bis zur Bereitstellung der DiGA-API sind folgende Schritte notwendig:
1. Nutzerkonto anlegen
Um einen Antrag auf Nutzung der DiGA-API einzureichen, benötigen Sie im ersten Schritt ein Nutzerkonto für das elektronische API-Antragsportal. Sie können das Nutzerkonto unter antrag-api.bfarm.de/de/nutzerkonto-anlegen anlegen.
2. Nutzerkonto aktivieren
Nach Anlage des Nutzerkontos erhalten Sie eine E-Mail mit einem Link zur Aktivierung Ihres Nutzerkontos. Mit dem Öffnen der angegebenen URL und der Festlegung eines Passworts ist das Nutzerkonto aktiv.
3. Antrag auf API-Nutzung einreichen
Innerhalb des elektronischen API-Antragsportals können Sie unter dem Menüpunkt Anträge
nun einen Antrag auf Nutzung der DiGA-API stellen. Ihr Antrag wird nach Einreichung durch das BfArM geprüft, Sie erhalten per E-Mail eine Benachrichtigung über Annahme oder Ablehnung Ihres Antrags.
Wo finde ich meine API-Zugangsdaten?
Mit Annahme Ihres Antrags auf Nutzung der DiGA-API erhalten Sie eine Benachrichtigung per E-Mail. Ab diesem Zeitpunkt haben Sie im Dashboard des elektronischen API-Antragsportals Zugriff auf Ihr individuelles API-Token (Bearer Token). Sie müssen Ihr Token vertraulich behandeln und dürfen es unter keinen Umständen weitergeben.
Fragen zur Profilierung: Questionnaire und QuestionnaireResponse
In den Instanzen des FHIR-Profils „QuestionnaireResponse“ wird im Element „questionnaire auf die dazugehörige Instanz des FHIR-Profils „Questionnaire“ mit der URL https://antrag.bfarm.de/de/intern/fragenkataloge/2 verwiesen, welche allerdings nicht zugänglich ist. Ist es möglich, stattdessen für alle DiGA die generische Instanz mit der URL https://diga.bfarm.de/api/fhir/v2.0/Questionnaire zu verwenden?
Das Feld „QuestionnaireResponse.questionnaire“ muss dem dem Feld „Questionnaire.canonical“ entsprechen und serverübergreifend eindeutig sein. Auf dem FHIR-Server können mehrere „Questionnaires“ gespeichert sein (z.B. DiGA und DiPA). Eine generische URL ist damit nicht möglich.
Eine direkt erreichbare URL ist in diesem Feld nicht zwingend notwendig. Das Feld kann mit der folgenden Abfrage genutzt werden um den „Questionnaire“ zu einem „QuestionnareResponse“ zu erhalten:
Die Verlinkung zwischen den Fragen und Antworten der Profilinstanzen „Questionnaire“ und „QuestionnaireResponse“ erfolgt über das Element „linkId“. Ist die Zuordnung der Werte dieser ID zu einzelnen Fragen und Fragenbereichen fix, so dass dieses Element zu deren Selektierung verwendet werden kann?
Die „linkId“ entspricht der internen ID der Assessments, Fragenblöcke und Fragen im Antragsportal. Die „linkId“ im „Questionnaire“ entspricht immer der passenden „linkId“ innerhalb der gleichen item-Ebene im „QuestionnaireResponse. Die „linkId“ kann also zur Selektion innerhalb der gleichen item-Ebene verwendet werden. Ebenenübergreifend kann die „linkId“ nicht verwendet werden, da die „linkId“ nicht global eindeutig ist.
Die Ids verändern sich nicht bei neuen Versionen des Fragenkatalogs. Es können aber neue Fragen mit neuen „linkIds“ hinzukommen, Fragen entfallen oder die Reihenfolge der Fragen sowie Typ und Text und mögliche Antworten der Fragen können sich ändern.
Neben dem Element „linkId“ existiert das Element „text“, mit dem einzelne Einträge des Fragenkatalogs selektiert werden können. Sind die Werte dieses Elements für bestimmte Fragenbereiche fix?
Die Werte des Feldes „text“ sind nicht fix. Die Werte können sich ändern, wenn der Fragenkatalog aktualisiert und BfArM-seitig Änderungen an den Texten vorgenommen werden (Name und Erläuterungstext der Assessments, Fragenblöcke und Fragen). Das „text“-Feld sollte daher nicht zur Selektion verwendet werden.