> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Reception API

Mit der Reception API kann ein Reception.ai-Reseller per Code erledigen, was im Reseller-Admin-Panel manuell möglich ist: für jeden Kunden einen Workspace erstellen, ihm einen Ihrer Pläne verkaufen, seine Rezeption einrichten und nachverfolgen, was Ihrer Karte belastet wird. Jeder Endpunkt befindet sich unter `https://api.elevenlabs.io/v1/reception` und ist in den Python- und TypeScript-SDKs als `reception` verfügbar.

> **Note**
>
> Das Reseller-Admin-Panel und damit die Reception API stehen nur Reception.ai-Partnern offen. Wenn
> Sie an einer Partnerschaft mit uns interessiert sind, [kontaktieren Sie unser Vertriebsteam](https://www.reception.ai/contact-sales).

## Authentifizierung

Erstellen Sie im Reseller-Admin-Panel einen API-Key. Nur dort erstellte Keys können die Reception API aufrufen; jeder andere ElevenLabs-API-Key wird mit `not_a_reseller_api_key` abgelehnt. Der Key wird nur einmal angezeigt. Speichern Sie ihn daher in einem Secret Manager.

Senden Sie den Key im Header `xi-api-key` oder setzen Sie `ELEVENLABS_API_KEY`, damit das SDK ihn ausliest.

## Reseller- und Workspace-Endpunkte

Die API arbeitet auf zwei Ebenen.

| Ebene     | Wirkt auf                                              | SDK-Gruppen                                                                                                                                           |
| --------- | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Reseller  | Ihr Reseller-Konto                                     | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| Workspace | Workspace eines Kunden, angegeben in `xi-workspace-id` | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

Workspace-Endpunkte benötigen den Header `xi-workspace-id`, der auf die ID eines von Ihnen erstellten Workspace gesetzt ist. Eine Anfrage ohne diesen Header oder für einen Workspace eines anderen Resellers wird abgelehnt. In den SDKs lautet der Header in Python als Argument `xi_workspace_id` und in TypeScript als Feld `xiWorkspaceId`.

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

workspaces = elevenlabs.reception.workspaces.list(page_size=50)
for workspace in workspaces.workspaces:
    print(workspace.workspace_id, workspace.business_name, workspace.billing_tier)

staff = elevenlabs.reception.staff.list(
    xi_workspace_id=workspaces.workspaces[0].workspace_id,
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const { workspaces } = await elevenlabs.reception.workspaces.list({ pageSize: 50 });
for (const workspace of workspaces) {
  console.log(workspace.workspaceId, workspace.businessName, workspace.billingTier);
}

const staff = await elevenlabs.reception.staff.list({
  xiWorkspaceId: workspaces[0].workspaceId,
});
```

```bash
elevenlabs reception workspaces list --page-size 50
```

## Paginierung

`workspaces.list` und `billing.list_invoices` geben jeweils eine Seite zurück. Übergeben Sie den `next_cursor` aus einer Antwort als `cursor`, um die nächste Seite abzurufen, und stoppen Sie, wenn `has_more` auf `false` gesetzt ist.

## Ratenlimits

Die Limits gelten pro Reseller über alle API-Keys hinweg:

| Anfragen                                | Limit          |
| --------------------------------------- | -------------- |
| Lesevorgänge (`GET`)                    | 600 pro Minute |
| Schreibvorgänge (alle anderen Methoden) | 120 pro Minute |

Eine Anfrage über dem Limit gibt `429` zurück. Warten Sie und wiederholen Sie sie.

## Nächste Schritte

* [Schnellstart](/docs/de/reception-ai/reception-api/quickstart): Erstellen Sie den Workspace eines Kunden und weisen Sie seiner Rezeption eine Telefonnummer zu.
* [Bereitstellung und Onboarding](/docs/de/reception-ai/reception-api/provisioning-and-onboarding): Beispiele zum Erstellen von Workspaces in großen Mengen sowie zum Hinzufügen von Standorten, Mitarbeitenden, Services und Rezeptionseinstellungen eines Unternehmens.
* [Abonnements und Abrechnung](/docs/de/reception-ai/reception-api/subscriptions-and-billing): Ändern Sie den Plan eines Kunden und sehen Sie, was Ihrer Karte belastet wird.