Einrichtung der Idana REST-API Schnittstelle

Idana lässt sich per REST-API mit anderen Softwarelösungen verknüpfen. Die Anbindung ist bereits fertig implementiert für:

• Docmedico
• Dubidoc
• 321med
• black.t

Für andere Systeme kann der API-Schlüssel ebenfalls erzeugt und für eine individuelle Integration genutzt werden.

API-Schlüssel erstellen

1. Öffnen Sie im Idana-Kundenportal Integrationen → API-Schlüssel (portal.idana.com/settings/api).
2. Klicken Sie auf „Neuen Schlüssel erstellen“ und vergeben Sie einen Namen und eine Beschreibung — z. B. den Namen der anzubindenden Software.
3. Kopieren Sie den Schlüssel — er wird nur einmal angezeigt — und bestätigen Sie mit „Ich habe den Schlüssel gespeichert“.
4. Hinterlegen Sie den Schlüssel in der anzubindenden Softwarelösung gemäß deren Dokumentation (bei Docmedico, Dubidoc, 321med und black.t ist die Anbindung bereits vorbereitet).

Der Schlüssel gilt für Ihren gesamten Praxis-Account. Nicht mehr benötigte Schlüssel können Sie dort jederzeit löschen.

Behandeln Sie den API-Schlüssel wie ein Passwort: Er erlaubt Zugriff auf Ihren Idana-Account und sollte nicht ungeschützt weitergegeben werden.

Datenschutz: Über die API werden Patientenstammdaten an Idana übermittelt. Informieren Sie Ihre Patient:innen darüber in Ihrer Datenschutzerklärung — die genauen Hinweise finden Sie auf der Seite der API-Schlüssel unter „Hinweise zur Übermittlung von Patientenstammdaten“.

Für eigene Integrationen: Die technische Dokumentation der Schnittstelle finden Sie unter backend.idana.app/external.

Siehe auch

• Einsatzmöglichkeiten — Überblick, wann eine API-Anbindung statt der Insellösung sinnvoll ist; listet zusätzlich Anleitungen für die Integration in gängige Terminkalender- und Praxisverwaltungssysteme (unabhängig von der REST-API).
• Idana als Insellösung einsetzen – ohne GDT-Anbindung — Alternative ohne Schnittstellen-Anbindung.