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

> Echtzeit-Benachrichtigungen über Webhooks empfangen

# Webhooks

Mit Webhooks erhalten Sie Echtzeit-HTTP-Benachrichtigungen, wenn Ereignisse in RxScale auftreten. Anstatt regelmäßig nach Änderungen abzufragen, registrieren Sie eine Webhook-URL, und RxScale sendet Ihnen bei jedem Ereignis eine POST-Anfrage.

## Funktionsweise von Webhooks

1. **Registrieren** Sie ein Webhook-Abonnement mit Ihrer Ziel-URL und dem gewünschten Ereignistyp.
2. **Empfangen** Sie POST-Anfragen an Ihre URL, wenn Ereignisse eintreten.
3. **Überprüfen** Sie die Webhook-Signatur, um die Authentizität der Anfrage sicherzustellen.
4. **Antworten** Sie mit einem `2xx`-Statuscode, um den Empfang zu bestätigen.

## Webhook-Payload-Format

Alle Webhook-Payloads folgen derselben Envelope-Struktur:

```json theme={null}
{
  "event_type": "pharmacy_order_created",
  "timestamp": 1711700000,
  "payload_version": "1",
  "data": {
    // Ereignisspezifische Daten
  }
}
```

| Feld              | Typ     | Beschreibung                                                                     |
| ----------------- | ------- | -------------------------------------------------------------------------------- |
| `event_type`      | string  | Der Typ des aufgetretenen Ereignisses                                            |
| `timestamp`       | integer | Unix-Zeitstempel der Ereigniserzeugung                                           |
| `payload_version` | string  | Schema-Version des Payloads (derzeit `"1"`)                                      |
| `data`            | object  | Ereignisspezifische Daten -- siehe [Ereignisse](/de/webhooks/events) für Details |

## Webhooks registrieren

Sie können Webhooks über folgende Wege registrieren:

* **Apothekenportal** -- Navigieren Sie zum API-Zugang in der Seitenleiste. Wenn Sie mehrere Apothekengruppen verwalten, wählen Sie die Gruppe aus dem Dropdown oben auf der Seite.
* **External Pharmacy API** -- `POST /v1/external_pharmacy_api/webhooks/`
* **Management API** -- `POST /v1/management/notification-subscriptions/`

Jede Registrierung gibt ein `signing_secret` zurück, das Sie sicher aufbewahren müssen, um Payloads zu verifizieren.

## Wiederholungsrichtlinie

Wenn Ihr Endpoint nicht mit einem `2xx`-Statuscode antwortet, wiederholt RxScale die Zustellung mit exponentiellem Backoff.