Anamnese

Externe Anamnesedaten übermitteln und mit Patienten verknüpfen

​

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"
}

Feld	Typ	Erforderlich	Beschreibung
data	object	Ja	Die Anamnese-Antwortdaten. Die Struktur hängt von der Fragebogendefinition ab
anamnesis_provider_uid	string	Ja	Ihre Anamnese-Anbieter-UID (von RxScale bereitgestellt)
external_identifier	string	Ja	Ihr 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"
}

Feld	Typ	Erforderlich	Beschreibung
shop_identifier	string	Ja	Ihr Shop-Bezeichner
shop_patient_id	string	Ja	Die 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.