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 | — |
| Rezerwacje | tak | dodawanie rezerwacji |
| Dostępność i kalendarz | tak | — |
| Blokady terminów | tak | — |
| Cennik, minimalne pobyty i opłaty | tak | — |
| Opinie gości | tak | — |
| Statystyki (obłożenie i przychód) | tak | — |
| Wiadomości do gości | tak | wysyłanie e-maila |
| Płatności | — | 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.
Powiązane artykuły: Serwer MCP — Claude i ChatGPT · Plany abonamentowe · Użytkownicy panelu · Statystyki · Eksport rezerwacji do CSV