T2med FHIR-API

Die T2med FHIR-API

Diese Seite richtet sich an Drittanbieter, die ihre Software bzw. ein Produkt an die externe T2med FHIR-API anbinden möchten. Wir laden Sie herzlich ein, einen Blick auf die technischen Spezifikationen der T2med-API zu werfen und zu entscheiden, ob eine Anbindung für Sie technisch in Frage kommt.

Neben der allgemeinen Beschreibung finden Sie auf dieser Seite insbesondere:

• den Integrationsleitfaden mit Ablauf, Authentifizierung, Endpunkten, Profilen, Fehlerbehandlung und HTTP-Beispielen,
• die Referenzumgebung (fhir-referenz.t2med.eu), eine öffentliche Testumgebung, in der Sie Ihre Anbindung ohne echte Praxisdaten entwickeln und prüfen können,
• die Demo-Anwendung (FHIR-demoapplication), eine öffentliche Desktop-Referenzimplementierung auf GitHub,
• eine FAQ-Rubrik, zusammengestellt aus wiederkehrenden Fragen von Drittanbietern.

Drittanbieter werden

Die T2med FHIR-API ermöglicht es externen Anwendungen, sich sicher mit T2med-Arztpraxen zu verbinden – zum Beispiel um Patienten zu suchen oder Inhalte direkt in die elektronische Akte zu schreiben. Die Anbindung erfolgt über einen modernen OAuth-Device-Flow und ist technisch genauso erreichbar wie der T2med-Client selbst. Bevor Sie sich als Drittanbieter registrieren, können Sie die Schnittstelle unverbindlich testen: Über unsere öffentliche Referenzumgebung sowie eine Demo-Anwendung mit Beispiel-Zugang im GitHub-Repository, inklusive vollständigem Integrationsleitfaden.

Bei Drittanbietern unterscheiden wir zwischen kommerziellen Anbietern und Community-Projekten:

In beiden Fällen wird der API-Key zentral von T2med je Drittanbieter ausgestellt und muss für jede Praxis-Installation einzeln freigeschaltet werden.

Ablauf

Nach erfolgreichen technischen Tests senden wir Ihnen auf Basis Ihres geplanten Pricing-Modells einen Vertragsentwurf zu. Nach Vertragsabschluss erhalten Sie Ihren produktiven API-Key – ein unkomplizierter und schneller Prozess.

Teil des Vertrags ist die Anlage 2 (Anwendungsbereich). Dort beschreiben Sie, wofür Ihr Produkt die FHIR-API nutzt: welche Aufrufe, mit welchem Zweck und in welchem Umfang. Der API-Key gilt für genau diesen Anwendungsbereich, so ist für beide Seiten klar, was freigegeben ist. Wollen Sie später weitere Funktionen nutzen, schreiben Sie Anlage 2 einfach fort und wir geben die Erweiterung frei. Was in Anlage 2 gehört und wie detailliert die Angaben sein sollten, erklärt der Leitfaden zu Anlage 2.

Schnelleinstieg

1. Mit dem Integrationsleitfaden das Grundprinzip (Kontext, Deep Link, API-Key) verstehen.
2. Die Demo-Anwendung gegen die Referenzumgebung fhir-referenz.t2med.eu ausprobieren.
3. Bei Fragen in den FAQs nachsehen.
4. Für den produktiven Zugang T2med kontaktieren — das benötigte Pricing-Modell wird für den Vertragsentwurf abgefragt.

Referenzumgebung

Die T2med-Referenzumgebung ist eine Testumgebung für die FHIR-API. Hier können Sie Ihre Anbindung gegen die API entwickeln und prüfen, ohne dass echte Praxisdaten im Spiel sind.

Adresse: fhir-referenz.t2med.eu (49.13.72.188)

Die vollständigen URLs mit Ports für FHIR-API und OAuth-Server finden Sie in der FAQ.

Wofür Sie die Referenzumgebung nutzen können

• Aufrufe der FHIR-API ausprobieren und Ihre Anbindung schrittweise entwickeln
• Die Abläufe aus dem Integrationsleitfaden praktisch nachvollziehen
• Die Tests der Go-live-Checkliste (Integrationsleitfaden, Abschnitt 11) durchführen, bevor Ihre Anbindung freigegeben wird

Gut zu wissen

• Die Referenzumgebung ist der gemeinsame Ausgangspunkt für alle Anbindungen. Egal ob Community-Projekt oder kommerzielles Produkt, jeder beginnt hier.
• Als Einstieg eignet sich der Integrationsleitfaden.
• Die FHIR-API wird laufend weiterentwickelt und bleibt dabei abwärtskompatibel. Bestehende Anbindungen müssen bei neuen Ausbaustufen also nicht umgebaut werden.