Zum Inhalt springen

medikATor – Schnittstelle für Praxissoftware

Praxisverwaltungs- und Klinikinformationssysteme binden den medikATor auf zwei Wegen ein: als Pop-up-Fenster mit Rückgabe des Ergebnisses an die Patientenakte oder direkt über die JSON-Schnittstelle. Erinnerungen für Laborkontrollen kommen als strukturierte Wiedervorlage und als Kalenderdatei (iCalendar) zurück.

Hinweis zur KI-Unterstützung: Die KI-Auswertung dient nur der Unterstützung und ersetzt keine ärztliche Verifikation. Weder die AT Medical GmbH noch die verwendete KI übernimmt Verantwortung für die Ergebnisse und darauf beruhende Therapieentscheidungen.

Praxisschlüssel

Jede Praxis oder Einrichtung erhält einen eigenen Schlüssel. Er wird in der Kopfzeile X-Medikator-Schluessel (gleichwertig: X-Medkator-Schluessel) oder als Authorization: Bearer … übertragen. In der Pilotphase bis 31.12.2026 ist die Nutzung kostenlos, danach mit Abonnement.

Wird geladen …

Variante 1: Pop-up aus der Praxissoftware

Die Praxissoftware öffnet die Seite in einem Fenster und übergibt die Medikation, ohne dass Daten über unseren Server laufen müssen. Nach der Prüfung schickt die Seite das Ergebnis per postMessage zurück an das öffnende Fenster.

const ursprung = location.origin;
const fenster = window.open('https://at-medical.de/de/digitale-loesungen/medikator/?einbettung=pvs&ursprung=' + encodeURIComponent(ursprung), 'medikator', 'width=1100,height=900');
window.addEventListener('message', (e) => {
  if (e.origin !== 'https://at-medical.de') return;
  if (e.data.typ === 'medikator:bereit') {
    fenster.postMessage({ typ: 'medikator:daten', version: '1',
      patient: { patient_id: '4711', geschlecht: 'weiblich', alter: 78, kreatinin: 1.4 },
      medikation: [{ name: 'Ramipril', staerke: '5 mg', morgens: '1', mittags: '0', abends: '0', nachts: '0' }],
      bmp: '<MP …>…</MP>' // optional: Inhalt des Datamatrix-Codes
    }, e.origin);
  }
  if (e.data.typ === 'medikator:ergebnis') {
    // e.data.pruefung.befundtext, e.data.pruefung.erinnerungen, e.data.merkblatt.text
  }
});

Ohne Skript im öffnenden Fenster genügt auch ein Link mit den Daten im Fragment (wird nicht an den Server gesendet): https://at-medical.de/de/digitale-loesungen/medikator/?einbettung=pvs#daten= + Base64url-kodiertes JSON im selben Format.

Variante 2: JSON-Schnittstelle

Basisadresse: https://at-medical.de/wp-json/atmed-medikator/v1 · Beschreibung als OpenAPI 3.1: openapi.yaml herunterladen

GET /statusDienststatus, Version, Pilotphase
POST /medikationsplan/bmpDatamatrix-Inhalt (XML) des BMP lesen; Namen und Geburtsdatum werden verworfen
POST /medikationsplan/bildFoto eines Plans per KI auslesen (flüchtig)
POST /regelwerkSofortprüfung nur mit dem Regelwerk, ohne KI
POST /pruefungenKI-Interaktionscheck starten (Antwort 202 mit Auftragsnummer)
GET /pruefungen/{id}Ergebnis abholen; danach wird es gelöscht
POST /merkblaetterPatientenmerkblatt in Laiensprache starten
GET /merkblaetter/{id}Merkblatt abholen
POST /erinnerungenWiedervorlagen für Laborkontrollen berechnen, mit iCalendar
curl -X POST 'https://at-medical.de/wp-json/atmed-medikator/v1/pruefungen' \
  -H 'X-Medikator-Schluessel: mk_…' -H 'Content-Type: application/json' \
  -d '{"patient":{"patient_id":"4711","geschlecht":"weiblich","alter":78,"kreatinin":1.4},
       "medikation":[{"name":"Simvastatin","staerke":"40 mg","abends":"1"},
                     {"name":"Clarithromycin","staerke":"500 mg","morgens":"1","abends":"1"}]}'
# Antwort 202: {"id":"…","status":"wartet","abruf":"…/pruefungen/…"}
curl 'https://at-medical.de/wp-json/atmed-medikator/v1/pruefungen/<id>' -H 'X-Medikator-Schluessel: mk_…'
# Antwort 202 solange die Auswertung läuft, danach 200 mit "ergebnis"

Ergebnisfelder für die Übernahme: befundtext (fertiger Text für die Akte), interaktionen, patientenbezogen, kontrollen, erinnerungen (Fälligkeitsdatum, Wiederholung als RRULE) und ics. Jede Antwort enthält den Haftungshinweis in hinweis_haftung; er ist bei der Anzeige in der Praxissoftware mit auszugeben.