> ## 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.

# Übersicht

> Management API für organisationsweiten Zugriff

# Management API

Die Management API bietet organisationsweiten Zugriff auf Bestellungen, Rezepte, Produkte, Ärzte, Patienten, Wartezimmer, Wallet Passes und Webhook-Abonnements. Sie ist für Back-Office-Integrationen und interne Tools konzipiert.

## Basispfad

```
/v1/management
```

## Interaktive API-Dokumentation (Swagger)

Eine Live-Swagger-Oberfläche steht zur Verfügung, um Endpoints direkt im Browser zu erkunden und zu testen:

```
https://api.rxscale.com/v1/management/apidocs
```

<Tip>
  Die Swagger-Oberfläche ermöglicht es Ihnen, API-Aufrufe interaktiv auszuprobieren. Authentifizieren Sie sich mit Ihrem API-Schlüssel, um gegen echte Daten zu testen.
</Tip>

## Authentifizierung

Alle Endpoints erfordern einen API-Schlüssel über den `X-API-Key`-Header. Management-API-Schlüssel sind auf eine **Organisation** beschränkt und können auf Daten aller Entitäten innerhalb dieser Organisation zugreifen. Siehe [Authentifizierung](/de/authentication) für Details.

```bash theme={null}
curl -X GET "https://api.rxscale.com/v1/management/health/" \
  -H "X-API-Key: your-api-key-here"
```

## Verfügbare Endpoints

| Methode  | Endpoint                                  | Beschreibung                             |
| -------- | ----------------------------------------- | ---------------------------------------- |
| `GET`    | `/orders`                                 | Bestellungen auflisten (paginiert)       |
| `GET`    | `/orders/{order_uid}`                     | Bestelldetails anzeigen                  |
| `GET`    | `/prescriptions/{prescription_uid}`       | Rezeptdetails anzeigen                   |
| `GET`    | `/products`                               | Produkte mit SKUs auflisten              |
| `GET`    | `/products/{product_uid}`                 | Produktdetails anzeigen                  |
| `GET`    | `/doctors`                                | Ärzte auflisten                          |
| `GET`    | `/doctors/{doctor_uid}/statistics`        | Rezeptstatistiken eines Arztes abrufen   |
| `GET`    | `/patients?email=...`                     | Patient per E-Mail suchen                |
| `GET`    | `/patients/{patient_uid}`                 | Patientenprofil anzeigen                 |
| `GET`    | `/patients/{patient_uid}/intent/{intent}` | Patienten-Intent prüfen                  |
| `POST`   | `/waiting-room/register`                  | Patient für das Wartezimmer registrieren |
| `GET`    | `/waiting-room/{queue_uid}/status`        | Warteschlangenstatus prüfen              |
| `DELETE` | `/waiting-room/{queue_uid}`               | Warteschlangenregistrierung stornieren   |
| `GET`    | `/wallet-passes/templates`                | Wallet-Pass-Vorlagen auflisten           |
| `GET`    | `/wallet-passes`                          | Wallet Passes auflisten                  |
| `POST`   | `/wallet-passes/push-notifications`       | Push-Benachrichtigungen senden           |
| `GET`    | `/notification-subscriptions`             | Webhook-Abonnements auflisten            |
| `POST`   | `/notification-subscriptions`             | Webhook-Abonnement registrieren          |
| `DELETE` | `/notification-subscriptions`             | Webhook-Abonnement entfernen             |
| `POST`   | `/notification-subscriptions/test`        | Webhook-Zustellung testen                |

## Erforderliche Berechtigungen

| Endpoint                              | Erforderliche Berechtigung            |
| ------------------------------------- | ------------------------------------- |
| Bestellungen anzeigen                 | `order:read`                          |
| Rezepte anzeigen                      | `prescription:read`                   |
| Produkte auflisten                    | `product:read`                        |
| Ärzte auflisten                       | `doctor:read`                         |
| Arztstatistiken                       | `doctor_statistics:read`              |
| Patienten anzeigen                    | `patient:read`                        |
| Wartezimmer registrieren / stornieren | `waiting_room:write`                  |
| Wartezimmerstatus anzeigen            | `waiting_room:read`                   |
| Wallet-Pass-Vorlagen auflisten        | `wallet_pass_template:read`           |
| Wallet Passes auflisten               | `wallet_pass:read`                    |
| Push-Benachrichtigungen senden        | `wallet_pass_push_notification:write` |

<Note>
  Webhook-Abonnement-Endpoints (notification-subscriptions) erfordern keine spezifische Berechtigung über einen gültigen Management-API-Schlüssel hinaus.
</Note>