API erphome.pl to interfejs REST, którym z własnego konta pobierzesz rezerwacje, zajęte terminy, cennik, opinie i statystyki, a także dodasz rezerwację ręczną, wyślesz e-mail do gościa i wygenerujesz link do płatności. Dane wracają w formacie JSON. To rozwiązanie dla osób, które chcą połączyć erphome.pl z własnym arkuszem, systemem księgowym, raportem albo narzędziem automatyzacji.
API jest w cenie każdego abonamentu. Nie musisz nic dokupować, wystarczy wystawić token.
Co możesz zrobić przez API
| Zasób | Odczyt | Zapis |
|---|---|---|
| Apartamenty (lista i identyfikatory) | tak | nie |
| Rezerwacje | tak | dodawanie rezerwacji |
| Dostępność i kalendarz | tak | nie |
| Blokady terminów | tak | nie |
| Cennik, minimalne pobyty i opłaty | tak | nie |
| Opinie gości | tak | nie |
| Statystyki (obłożenie i przychód) | tak | nie |
| Wiadomości do gości | tak | wysyłanie e-maila |
| Płatności | nie | generowanie linku (Przelewy24) |
Adres bazowy to https://api.erphome.pl/v1, a pełną dokumentację techniczną z opisem wszystkich endpointów znajdziesz pod api.erphome.pl/docs (standard OpenAPI 3.1).
Kto może tworzyć tokeny
Tokeny API tworzy wyłącznie właściciel konta. Użytkownicy panelu dodani do konta nie widzą tej sekcji, nawet z pełnymi uprawnieniami. Token daje dostęp do danych całego konta, więc pozostaje w rękach właściciela.
Jak wystawić token
- W panelu przejdź do zakładki API.
- Kliknij „Nowy token" i nadaj mu nazwę (np. „Arkusz przychodów" albo „Make.com"), po niej rozpoznasz, do czego służy.
- Zaznacz zakresy, których token ma dotyczyć. Odczyt (
:read) i zapis (:write) to osobne uprawnienia: integracja raportowa dostaje wtedy token, którym fizycznie nie da się niczego zmienić. - Opcjonalnie ogranicz token do wybranych adresów IP (patrz niżej).
- Zapisz: token pokaże się tylko raz. Skopiuj go od razu i zapisz w bezpiecznym miejscu; zaczyna się od
erph_live_.
Token zobaczysz w całości jeden jedyny raz, w chwili utworzenia. Jeśli go zgubisz, nie da się go odczytać ponownie: odwołaj stary i wystaw nowy.
Ograniczenie do adresów IP
Przy każdym tokenie możesz podać listę dozwolonych adresów IP lub zakresów (CIDR, IPv4 i IPv6). Domyślnie token działa z dowolnego adresu. Ograniczenie to druga warstwa obok samego sekretu: wykradziony token przestaje działać poza siecią Twojej integracji. Nad polem pokazujemy adres, z którego właśnie korzystasz, dzięki temu nie zablokujesz sobie dostępu literówką.
Odwoływanie tokenu
Token, którego już nie używasz albo który mógł wyciec, odwołaj przyciskiem przy jego nazwie. Przestaje działać natychmiast. Możesz też w każdej chwili zmienić samą listę adresów IP bez wystawiania nowego tokenu.
Automatyzacja bez kodu (Make, Zapier, n8n)
Nie musisz pisać własnego programu. Token Bearer wkleisz do popularnych narzędzi automatyzacji, Make.com, Zapier czy n8n, i zbudujesz przepływy „przy nowej rezerwacji dopisz wiersz do arkusza" bez kodu. Do potwierdzenia i opisania połączenia w takim narzędziu służy endpoint GET /me (tożsamość konta), który działa z każdym ważnym tokenem, niezależnie od zakresów.
Chcesz podłączyć asystenta AI, np. Claude albo ChatGPT? Zobacz Serwer MCP: Claude i ChatGPT. Używa tych samych tokenów i zakresów, ale bez pisania kodu.
Najczęstsze pytania
Czy API jest dodatkowo płatne?
Nie. API jest w cenie każdego abonamentu, nic nie dokupujesz, wystarczy wystawić token w zakładce API.
Kto może tworzyć tokeny API?
Tylko właściciel konta. Użytkownicy panelu nie widzą tej sekcji nawet z pełnymi uprawnieniami, bo token daje dostęp do danych całego konta.
Zgubiłem token. Jak go odzyskać?
Nie da się. Pełny token widać tylko raz, w chwili utworzenia. Jeśli go zgubisz, odwołaj stary przyciskiem przy nazwie i wystaw nowy. Dla bezpieczeństwa możesz ograniczyć token zakresami i adresami IP.
Powiązane artykuły: Serwer MCP: Claude i ChatGPT · Plany abonamentowe · Użytkownicy panelu · Statystyki · Eksport rezerwacji do CSV