Start

Publiczne API Rezeri pozwala wpiąć rezerwacje organizacji we własną stronę, aplikację albo system. Możesz pokazać wolne terminy bez widgetu, przyjąć rezerwację, otworzyć płatność online i anulować wizytę. Możesz też zsynchronizować rezerwacje z CRM-em albo arkuszem.

API jest przeznaczone do wywołań z serwera. Klucz API jest tajny — nie umieszczaj go w kodzie przeglądarki ani aplikacji mobilnej.

Co obejmuje v1

• Usługi i pracownicy — oferta organizacji widoczna publicznie, tak jak w widgecie.
• Dostępność — wolne terminy usługi w zakresie dat.
• Rezerwacje — odczyt, lista z filtrami, tworzenie i anulowanie.
• Płatności online — sesja płatności dla rezerwacji i jej ponowienie.

Przełożenie wizyty, kartoteka klientów i konfiguracja usług nie są częścią v1. Klient końcowy przekłada wizytę pod adresem manage_url z odpowiedzi rezerwacji.

Adres API

API działa pod adresem https://api.rezeri.com/v1 i przyjmuje klucze rez_live_…. Klucz utworzy właściciel organizacji, której plan obejmuje dostęp do API (zobacz cennik). Integrację sprawdzisz na własnym koncie — zobacz Testowanie integracji.

Zasady, które obowiązują wszędzie

• Uwierzytelnianie — nagłówek Authorization: Bearer <klucz>. Zobacz Uwierzytelnianie i scopes.
• JSON w snake_case. Body żądania odrzuca nieznane pola (422 unknown_field). Odpowiedzi mogą dostać nowe pola i nowe wartości enumów — Twój kod ma je ignorować. Zobacz Wersjonowanie.
• Czas — ISO 8601 z offsetem strefy organizacji (dziś Europe/Warsaw, czyli +01:00 albo +02:00). W żądaniach podawaj czas zawsze z offsetem.
• Kwoty — string dziesiętny z dwoma miejscami po przecinku ("150.00") i pole currency ("PLN"). Nigdy liczba zmiennoprzecinkowa.
• Listy — usługi, pracownicy, rezerwacje i endpointy webhooków mają paginację kursorem: odpowiedź {data, has_more, next_cursor}, parametry limit (1–100, domyślnie 20) i cursor. Wyjątek: GET /v1/availability zwraca same data dla podanego zakresu dat, bez paginacji.
• Błędy — format RFC 9457 ze stałym polem code. Zobacz Błędy.
• Zasoby innej organizacji — zawsze 404 not_found, nigdy 403.
• Limity — 120 żądań na minutę na klucz. Zobacz Limity.
• Ponawianie zapisu — nagłówek Idempotency-Key. Zobacz Idempotencja.

Gdzie dalej

1. Szybki start — pierwsza rezerwacja w 5 minut.
2. Testowanie integracji — rezerwacja testowa, historia dostaw i przykładowe zdarzenia webhooka, płatności w trybie testowym.
3. Rezerwacje i dostępność — pełny przepływ rezerwacji.
4. Płatności online — rezerwacja płatna z góry.
5. Referencja API — wszystkie endpointy, parametry i pola.