Powrót do bloga

Oprogramowanie dla parków rekreacyjnych API-first: Tillor jako headless platforma

Buduj na infrastrukturze campingowej headless z OpenAPI, webhookami i zdarzeniami w czasie rzeczywistym. Pełne CRUD na kluczowych encjach; rozszerzamy API tam, gdzie tego wymaga integracja.

API
OpenAPI
Webhooki
Integracje
Oprogramowanie dla parków rekreacyjnych API-first: Tillor jako headless platforma

API to sposób, w jaki inny program rozmawia z Tillor: Twoja strona, pakiet księgowy lub własna aplikacja może odczytywać rezerwacje i faktury bez otwierania biurka Tillor. OpenAPI to oficjalna lista tego, co jest dostępne; webhooki to automatyczne sygnały, gdy coś się dzieje, np. faktura opłacona.

Parki rekreacyjne rzadko działają na jednym gotowym pakiecie. Masz CRM, oprogramowanie księgowe, własną stronę, czasem sprzęt na miejscu. Jako oprogramowanie dla parków rekreacyjnych Tillor musi służyć jako backend dla tego stosu. Aplikacja webowa to jeden klient tego samego API, z którego korzystają integratorzy.

Chcemy, żebyś budował procesy bez obejść. Każdy endpoint organizacji jest opublikowany w OpenAPI, dostarczamy webhooki i SSE dla zdarzeń oraz wspieramy MQTT, gdy lepiej pasuje pub/sub. Brakuje czegoś dla poważnej integracji? Porozmawiaj z nami: pełne CRUD na kluczowych encjach to standard, a endpointy możemy rozszerzyć, gdy use case tego uzasadnia.

🔌 OpenAPI to źródło prawdy

Każdy endpoint organizacji jest w specyfikacji OpenAPI i można go przetestować w dokumentacji API. List, read, create, update i delete dla klientów, obłożeń, faktur, produktów, liczników i zadań jest dostępne dziś; specyfikacja pokazuje dokładnie, które metody są aktywne dla danego zasobu.

Kopiuj link do tej sekcjiScenariusze integratorów

Własny widget rezerwacji. Twoja strona wysyła rezerwacje prosto do Tillor, odczytuje dostępność przez endpointy list i wysyła potwierdzenia z własnego stosu. Tillor pozostaje źródłem obłożeń i fakturowania.

Hurtownia danych lub BI. Nocne zadania pobierają klientów, otwarte faktury i odczyty liczników przez paginowane wywołania list. Bez nieaktualnego eksportu CSV; czytasz te same pola co recepcja.

Powiązanie oparte na zdarzeniach. Przy faktura opłacona lub klient utworzony webhook uruchamia Twoją warstwę pośrednią. Wolisz otwarty strumień? SSE dostarcza te same klucze zdarzeń na żywo.

Sprzęt na miejscu. Szlabany, drukarki i czytniki dokumentów rozmawiają lokalnie przez Connector; integracja w chmurze zostaje na HTTP i zdarzeniach.

Kopiuj link do tej sekcjiCRUD na kluczowych encjach

Dla każdej bazowej encji w Tillor cel jest jasny: powinieneś móc listować, odczytywać, tworzyć, aktualizować i usuwać rekordy przez HTTP bez otwierania interfejsu.

W praktyce, na ścieżce org pod /api/orgs/{orgId}/...:

AkcjaTypowa metoda HTTP
Lista (paginacja i filtry)GET na kolekcji
OdczytGET na {id}
UtworzeniePOST
AktualizacjaPATCH lub PUT (częściowa vs pełna zamiana, wg encji w OpenAPI)
UsunięcieDELETE

Dziś klienci, obłożenia, faktury, produkty, liczniki i zadania podążają za tym wzorcem. Rezerwacje i tereny idą w tym samym kierunku; sprawdź OpenAPI dla aktualnego zestawu metod na zasób.

Akcje procesowe (check-in, zaksięgowanie faktury, przedłużenie pobytu) dostają jawny endpoint zamiast ukrytej akcji ekranu. Integracja pozostaje stabilna, gdy interfejs się zmienia.

Kopiuj link do tej sekcjiElastyczność i rozszerzenia

Tillor nie jest zamkniętą wyspą. Chcemy, żeby partnerzy wpięli Tillor w istniejące środowisko:

  • Standardowy REST ze schematami Zod wejścia i wyjścia w OpenAPI
  • URL-e w zakresie org i nagłówki (x-api-key, X-Tillor-Org-Id) jak w HTTP API
  • Limity zapytań, które możesz zaplanować (5000 żądań na 60 sekund na klucz)
  • Te same zdarzenia przez webhook, SSE lub MQTT, w zależności od tego, co lepiej obsługuje Twój stos

Potrzebujesz dodatkowego filtra listy, akcji masowej lub brakującego delete dla integracji? Na życzenie uzgadniamy rozszerzenia API, gdy pasują do modelu danych i przynoszą korzyść innym klientom. Bez tajnych one-offów: nowe endpointy trafiają do OpenAPI, żeby każdy mógł z nich korzystać.

Kopiuj link do tej sekcjiKorzyści dla projektu

  • Jeden kontrakt: OpenAPI + dokumentacja API, bez reverse engineeringu interfejsu
  • Headless platforma: Tillor jako backend dla front-endu, portalu lub aplikacji mobilnej
  • Zdarzenia od razu: pomiń polling, gdy wystarczy webhook lub SSE
  • Lokalnie + chmura: Connector dla sprzętu on-prem, API dla systemów centralnych
  • Dokumentacja dla AI i codegen: dokumentacja dla deweloperów i llms-full.txt dla narzędzi

Kopiuj link do tej sekcjiJak to wygląda dla integratorów

Każda integracja zaczyna się od klucza API: otwórz menu użytkownika (podświetlenie 1) i przejdź do Klucze API (podświetlenie 2).

Uwierzytelnianie, nagłówki org, limity, webhooki i przykłady kodu są w HTTP API, Webhooki i Przykłady. Testuj endpointy w dokumentacji API lub przez OpenAPI.


Budujesz na Tillor? Zamów demo, a wspólnie przejrzymy OpenAPI, zdarzenia i Twój use case.