Wprowadziliśmy nową funkcję – REST API.
Dzięki niej łatwiej połączysz system z innymi narzędziami, zautomatyzujesz procesy i będziesz pracować na tych samych danych w różnych systemach.systemu.
To rozwiązanie dla obiektów, które chcą dopasować system do własnych procesów, a nie odwrotnie.
Czym jest REST API ?
REST API to standard komunikacji, który pozwala Twoim systemom bezpośrednio wymieniać dane z mobile-calendar. Zamiast ręcznego eksportu, kopiowania informacji czy pracy na kilku panelach – dane synchronizują się automatycznie.
Dzięki temu możesz:
- integrować mobile-calendar z własnymi aplikacjami i systemami IT,
- budować automatyzacje dopasowane do sposobu pracy obiektu,
- mieć zawsze aktualne i spójne dane w wielu narzędziach jednocześnie.
API nie zastępuje interfejsu użytkownika – rozszerza go o nowe możliwości.
Operacje CRUD – pełna kontrola nad danymi
REST API w mobile-calendar obsługuje pełny zakres operacji CRUD, czyli:
- tworzenie danych,
- odczyt,
- aktualizację,
- usuwanie rekordów.
W praktyce oznacza to, że możesz w pełni zarządzać kluczowymi zasobami systemu poprzez standardowe żądania HTTP. API obejmuje wszystkie najważniejsze obszary działania obiektu noclegowego:
- /reservations – rezerwacje, statusy, terminy pobytu
- /guests – dane gości, informacje kontaktowe i historia pobytów
- /rooms – konfiguracja pokoi, dostępność, ustawienia
- /invoices – faktury, płatności i dokumenty finansowe
Każdy z tych endpointów pozwala na budowanie zarówno prostych integracji, jak i zaawansowanych scenariuszy automatyzacji.
Przykłady zastosowań REST API
Dostęp do API daje ogromną elastyczność. W praktyce możesz na przykład:
- automatycznie przekazywać nowe rezerwacje do zewnętrznych systemów,
- synchronizować dane gości z CRM lub narzędziami marketingowymi,
- generować raporty i zestawienia bez ręcznej pracy,
- integrować mobile-calendar z systemami księgowymi lub BI,
- budować własne aplikacje wspierające obsługę recepcji lub administracji.
To szczególnie ważne dla obiektów, które rosną i potrzebują skalowalnych rozwiązań, a nie kolejnych ręcznych procesów.
Webhooks – zdarzenia w czasie rzeczywistym
Oprócz klasycznego REST API dostępne są również webhooki, które pozwalają reagować na zdarzenia dokładnie w momencie, gdy się wydarzą.
Zamiast cyklicznie pytać API o zmiany, system sam wysyła powiadomienie na wskazany adres URL. Obsługiwane są między innymi zdarzenia:
- utworzenie nowej rezerwacji,
- modyfikacja rezerwacji,
- anulowanie,
- zameldowanie gościa.
Webhooki działają w oparciu o bezpieczne połączenia HTTPS, obsługują automatyczne ponowne próby i pozwalają precyzyjnie określić zakres interesujących zdarzeń. To idealne rozwiązanie dla systemów, które muszą reagować natychmiast.
Panel logów deweloperskich – pełna widoczność integracji
W planie Premium dostępny jest także panel logów deweloperskich, który znacząco ułatwia pracę z API. Bezpośrednio w aplikacji możesz:
- przeglądać historię zapytań API (do 30 dni),
- analizować pełne odpowiedzi serwera,
- szybko identyfikować błędy i problemy integracyjne.
Dzięki temu wdrażanie i utrzymanie integracji jest prostsze, bezpieczniejsze i przewidywalne.
Dokumentacja REST API
Aby ułatwić start, przygotowaliśmy szczegółową dokumentację zawierającą opisy endpointów, struktury danych oraz przykłady zapytań i odpowiedzi.
👉 Pełna dokumentacja REST API:
https://mobile-calendar.gitbook.io/v1
Dostępne w planie Premium 💎
REST API, webhooks oraz panel logów deweloperskich są dostępne w planie Premium. To rozwiązanie stworzone dla obiektów, które chcą:
- automatyzować procesy,
- integrować system z własnymi narzędziami,
- mieć pełną kontrolę nad danymi i przepływem informacji.
