Zum Hauptinhalt springen

​
Anamnese

Die Anamnese-API ermöglicht es externen Anbietern, medizinische Fragebogenantworten (Anamnesedaten) zu übermitteln und mit Patienten im RxScale-System zu verknüpfen.

​
Basispfad

/api/v3-1/anamnesis

​
Authentifizierung

Alle Endpoints erfordern einen API-Schlüssel über den X-API-Key-Header. Siehe Authentifizierung für Details.
Der veraltete X-RxScale-Authorization-Header wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt, jedoch wird X-API-Key für neue Integrationen empfohlen.

​
Externe Anamnese übermitteln

Übermitteln Sie Anamnesedaten eines externen Anbieters für einen bestimmten Fragebogen. 
POST /api/v3-1/anamnesis/questionnaires/{questionnaire_uid}/external/submissions
​
questionnaire_uid
string
erforderlich
Die UID des Fragebogens, für den die Anamnese übermittelt werden soll

​
Anfragekörper

{
  "data": {
    "lastName": "Müller",
    "dob": "1990-05-15"
  },
  "anamnesis_provider_uid": "fc9ef771-79a4-4f60-a930-d62a3527565e",
  "external_identifier": "ext-submission-001"
}
FeldTypErforderlichBeschreibung
dataobjectJaDie Anamnese-Antwortdaten. Die Struktur hängt von der Fragebogendefinition ab
anamnesis_provider_uidstringJaIhre Anamnese-Anbieter-UID (von RxScale bereitgestellt)
external_identifierstringJaIhr externer Bezeichner für diese Übermittlung (zur Nachverfolgung)

​
Beispielanfrage

curl -X POST "https://api.rxscale.com/api/v3-1/anamnesis/questionnaires/abc123-def456/external/submissions" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {"lastName": "Müller", "dob": "1990-05-15"},
    "anamnesis_provider_uid": "fc9ef771-79a4-4f60-a930-d62a3527565e",
    "external_identifier": "ext-submission-001"
  }'
Die Struktur des data-Objekts muss mit den im Fragebogen definierten Feldern übereinstimmen. Kontaktieren Sie Ihren RxScale-Ansprechpartner, um das Fragebogenschema zu erhalten.

​
Anamnese mit Patient verknüpfen

Verknüpfen Sie eine übermittelte Anamnese mit einem Patientenprofil anhand der Shop-Kunden-ID. 
POST /api/v3-1/anamnesis/{anamnesis_uid}/patient
​
anamnesis_uid
string
erforderlich
Die UID der zu verknüpfenden Anamnese-Übermittlung

​
Anfragekörper

{
  "shop_identifier": "my-store.myshopify.com",
  "shop_patient_id": "CUST123"
}
FeldTypErforderlichBeschreibung
shop_identifierstringJaIhr Shop-Bezeichner
shop_patient_idstringJaDie Kunden-ID aus Ihrem Shop-System

​
Beispielanfrage

curl -X POST "https://api.rxscale.com/api/v3-1/anamnesis/xyz789/patient" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "shop_identifier": "my-store.myshopify.com",
    "shop_patient_id": "CUST123"
  }'
Jede Anamnese-Übermittlung kann nur mit einem Patienten verknüpft werden. Der Versuch, eine bereits verknüpfte Anamnese erneut zuzuordnen, führt zu einem Fehler.

​
Typischer Integrationsablauf

1

Anamnese übermitteln

Ihr externes System erfasst die Fragebogenantworten des Patienten und übermittelt diese über den Endpoint für externe Übermittlungen.
2

Anamnese-UID erhalten

Die API gibt eine Anamnese-UID zurück, die Sie zusammen mit der Übermittlung in Ihrem System speichern.
3

Mit Patient verknüpfen

Wenn der Patient in Ihrem Shop identifiziert wird (z. B. beim Checkout), verknüpfen Sie die Anamnese mit seinem Patientenprofil.
4

Ärztliche Prüfung

Die verknüpfte Anamnese steht zur ärztlichen Prüfung im RxScale-Arztportal zur Verfügung.