> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rxscale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Patientendaten

> Patientenabsicht abfragen und Patienteneigenschaften verwalten

# Patientendaten

Greifen Sie auf patientenspezifische Daten wie den Absichtsstatus und benutzerdefinierte Eigenschaften zu. Diese Endpoints verwenden die Shop-Kunden-ID und den Shop-Bezeichner zur Identifizierung von Patienten.

## Patientenabsicht prüfen

Fragen Sie ab, ob ein Patient eine bestimmte Absicht abgeschlossen hat (z. B. das Ausfüllen eines Fragebogens).

```bash theme={null}
GET /api/v0/patient/intent
```

<ParamField query="shop_customer_id" type="string" required>
  Die Kunden-ID aus Ihrem Shop-System
</ParamField>

<ParamField query="shop_identifier" type="string" required>
  Ihr Shop-Bezeichner (z. B. `my-store.myshopify.com`)
</ParamField>

<ParamField query="intent" type="string" required>
  Der zu prüfende Absichtsbezeichner
</ParamField>

### Beispielanfrage

```bash theme={null}
curl -X GET "https://api.rxscale.com/api/v0/patient/intent?shop_customer_id=CUST123&shop_identifier=my-store.myshopify.com&intent=weight-loss-questionnaire" \
  -H "X-API-Key: your-api-key-here"
```

### Antwort

```json theme={null}
{
  "return_code": "signed_within_12_months"
}
```

Der `return_code` gibt an, wann der Patient zuletzt eine signierte Einreichung für die angegebene Absicht abgeschlossen hat.

<Warning>
  Dieser Endpoint gibt `404` zurück, wenn der Patient RxScale nicht bekannt ist. Wenn der Patient gerade erst erstellt wurde (z.B. während eines Shopify-Checkouts), ist sein Profil möglicherweise nicht sofort verfügbar. Warten Sie 1–2 Sekunden und versuchen Sie es erneut, bevor Sie einen `404` als endgültiges „Patient nicht gefunden" behandeln.
</Warning>

## Patienteneigenschaft abrufen

Rufen Sie einen bestimmten Eigenschaftswert für einen Patienten ab.

```bash theme={null}
GET /api/v0/patient/properties
```

<ParamField query="shop_customer_id" type="string" required>
  Die Kunden-ID aus Ihrem Shop-System
</ParamField>

<ParamField query="shop_identifier" type="string" required>
  Ihr Shop-Bezeichner
</ParamField>

<ParamField query="field" type="string" required>
  Der Name des abzurufenden Eigenschaftsfelds. Sie finden den Feldschlüssel im Admin-Tool unter **Einstellungen > Profilfelder** — verwenden Sie den dort angezeigten **Key**-Wert für jedes Feld.
</ParamField>

### Beispielanfrage

```bash theme={null}
curl -X GET "https://api.rxscale.com/api/v0/patient/properties?shop_customer_id=CUST123&shop_identifier=my-store.myshopify.com&field=allergies" \
  -H "X-API-Key: your-api-key-here"
```

## Patienteneigenschaft setzen

Setzen oder aktualisieren Sie einen Eigenschaftswert für einen Patienten.

```bash theme={null}
POST /api/v0/patient/properties
```

<ParamField query="shop_customer_id" type="string" required>
  Die Kunden-ID aus Ihrem Shop-System
</ParamField>

<ParamField query="shop_identifier" type="string" required>
  Ihr Shop-Bezeichner
</ParamField>

### Anfragekörper (form-data)

| Feld    | Typ    | Erforderlich | Beschreibung                   |
| ------- | ------ | ------------ | ------------------------------ |
| `field` | string | Ja           | Der Name des Eigenschaftsfelds |
| `value` | string | Ja           | Der zu setzende Wert           |

### Beispielanfrage

```bash theme={null}
curl -X POST "https://api.rxscale.com/api/v0/patient/properties?shop_customer_id=CUST123&shop_identifier=my-store.myshopify.com" \
  -H "X-API-Key: your-api-key-here" \
  -F "field=allergies" \
  -F "value=penicillin"
```

<Note>
  Patienteneigenschaften sind benutzerdefinierte Felder, die pro Organisation konfiguriert werden. Sie können die verfügbaren Eigenschaftsfelder im Bereich **Einstellungen > Profilfelder** des Admin-Tools konfigurieren.
</Note>