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

# API Reception

API Reception pozwala resellerowi Reception.ai robić w kodzie to, co panel administracyjny resellera pozwala zrobić ręcznie: utworzyć obszar roboczy dla każdego klienta, sprzedać mu jeden z twoich planów, skonfigurować jego recepcjonistę i śledzić obciążenia twojej karty. Wszystkie endpointy znajdują się pod `https://api.elevenlabs.io/v1/reception` i są dostępne w SDK Python i TypeScript jako `reception`.

> **Note**
>
> Panel administracyjny resellera, a wraz z nim API Reception, jest dostępny tylko dla partnerów Reception.ai. Jeśli
> interesuje cię współpraca z nami, [skontaktuj się z naszym zespołem sprzedaży](https://www.reception.ai/contact-sales).

## Uwierzytelnianie

Utwórz klucz API w panelu administracyjnym resellera. Tylko klucze utworzone tam mogą wywoływać API Reception; każdy inny klucz API ElevenLabs zostanie odrzucony z `not_a_reseller_api_key`. Klucz jest wyświetlany tylko raz, więc zapisz go w menedżerze sekretów.

Wyślij klucz w nagłówku `xi-api-key` albo ustaw `ELEVENLABS_API_KEY`, aby SDK odczytało go automatycznie.

## Endpointy resellera i obszaru roboczego

API działa na dwóch poziomach.

| Poziom         | Dotyczy                                                           | Grupy SDK                                                                                                                                             |
| -------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Reseller       | Twojego konta resellera                                           | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| Obszar roboczy | Obszaru roboczego jednego klienta, wskazanego w `xi-workspace-id` | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

Endpointy obszaru roboczego wymagają nagłówka `xi-workspace-id` ustawionego na ID utworzonego przez ciebie obszaru roboczego. Żądanie bez niego lub dotyczące obszaru należącego do innego resellera zostanie odrzucone. W SDK nagłówek to argument `xi_workspace_id` w Pythonie oraz pole `xiWorkspaceId` w TypeScript.

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

## Stronicowanie

`workspaces.list` i `billing.list_invoices` zwracają po jednej stronie wyników. Przekaż `next_cursor` z odpowiedzi jako `cursor`, aby pobrać kolejną stronę, i zakończ, gdy `has_more` ma wartość `false`.

## Limity żądań

Limity obowiązują na resellera, dla wszystkich jego kluczy API:

| Żądania                             | Limit         |
| ----------------------------------- | ------------- |
| Odczyty (`GET`)                     | 600 na minutę |
| Zapisy (wszystkie pozostałe metody) | 120 na minutę |

Żądanie ponad limit zwraca `429`. Poczekaj i spróbuj ponownie.

## Co dalej

* [Szybki start](/docs/pl/reception-ai/reception-api/quickstart): utwórz obszar roboczy klienta i przypisz jego recepcjonistę do numeru telefonu.
* [Provisioning i onboarding](/docs/pl/reception-ai/reception-api/provisioning-and-onboarding): przykłady masowego tworzenia obszarów roboczych oraz dodawania lokalizacji, personelu, usług i ustawień recepcjonisty firmy.
* [Subskrypcje i rozliczenia](/docs/pl/reception-ai/reception-api/subscriptions-and-billing): zmień plan klienta i sprawdź obciążenia twojej karty.