Torna al blog

Software parco vacanze API-first: Tillor come piattaforma headless

Costruite su Tillor come piattaforma headless per campeggi: OpenAPI, webhooks ed eventi in tempo reale. CRUD completo sulle entità principali; estendiamo l'API dove serve la vostra integrazione.

API
OpenAPI
Webhooks
Integrazioni
Software parco vacanze API-first: Tillor come piattaforma headless

Un'API è il modo in cui un altro programma parla con Tillor: il vostro sito web, il pacchetto contabile o l'app personalizzata possono leggere prenotazioni e fatture senza aprire Tillor alla reception. OpenAPI è l'elenco ufficiale di ciò che è disponibile; i webhooks sono segnali automatici quando succede qualcosa, ad esempio fattura pagata.

I parchi ricreativi raramente girano su un unico pacchetto standard. Come software per parchi ricreativi, Tillor deve servire da backend per quello stack: l'app web è un client sulla stessa API usata dagli integratori.

Vogliamo che costruite flussi di lavoro senza workaround. Ogni endpoint organizzazione è pubblicato in OpenAPI, forniamo webhooks e SSE per gli eventi, e supportiamo MQTT dove pub/sub funziona meglio. Manca qualcosa per un'integrazione seria? Parlatene con noi: CRUD completo sulle entità principali è la base, e possiamo estendere gli endpoint dove il vostro caso d'uso lo giustifica.

🔌 OpenAPI è la fonte di verità

Ogni endpoint organizzazione è in OpenAPI e si prova nel riferimento API. Elencare, leggere, creare, aggiornare ed eliminare per clienti, occupazioni, fatture, prodotti, contatori e attività è disponibile oggi; la spec mostra esattamente quali metodi sono attivi per risorsa.

Copia link a questa sezioneScenari per integratori

Il vostro widget di prenotazione. Il sito invia prenotazioni direttamente a Tillor, legge la disponibilità tramite endpoint di elenco e manda la mail di conferma dal vostro stack. Tillor resta la fonte per occupazioni e fatturazione.

Data warehouse o BI. Job notturni estraggono clienti, fatture aperte e letture contatori tramite chiamate di elenco paginate. Niente export CSV obsoleto; leggete gli stessi campi della reception.

Accoppiamento event-driven. Su fattura pagata o cliente creato, un webhook attiva il vostro middleware. Preferite uno stream aperto? SSE consegna le stesse chiavi evento in live.

Hardware in loco. Sbarre, stampanti e lettori identità parlano in locale tramite il Connector; la vostra integrazione cloud resta su HTTP ed eventi.

Copia link a questa sezioneCRUD sulle entità principali

Per ogni entità base in Tillor l'obiettivo è chiaro: poter elencare, leggere, creare, aggiornare ed eliminare record via HTTP senza aprire l'interfaccia.

In pratica, per percorso org sotto /api/orgs/{orgId}/...:

AzioneMetodo HTTP tipico
Elenco (paginazione e filtri)GET sulla collection
LetturaGET su {id}
CreazionePOST
AggiornamentoPATCH o PUT (parziale vs sostituzione completa, per entità in OpenAPI)
EliminazioneDELETE

Oggi clienti, occupazioni, fatture, prodotti, contatori e attività seguono quel pattern. Prenotazioni e terreni vanno nella stessa direzione; controllate OpenAPI per il set di metodi attuale per risorsa.

Le azioni di flusso (check-in, registrazione fattura, prolungamento soggiorno) hanno un endpoint esplicito invece di un'azione nascosta nella schermata. La vostra integrazione resta stabile mentre l'interfaccia evolve.

Copia link a questa sezioneFlessibilità ed estensione

Tillor non è un'isola chiusa. Vogliamo che i partner inseriscano Tillor nei paesaggi esistenti:

  • REST standard con input e output schematizzati Zod in OpenAPI
  • URL e header per org (x-api-key, X-Tillor-Org-Id) come documentato in HTTP API
  • Rate limit pianificabili (5000 richieste per 60 secondi per chiave)
  • Gli stessi eventi via webhook, SSE o MQTT, quello che il vostro stack gestisce meglio

Serve un filtro elenco extra, un'azione bulk o un delete mancante per un'accoppiatura? Su richiesta concordiamo estensioni API quando rientrano nel modello dati e avvantaggiano altri clienti. Niente one-off segreti: i nuovi endpoint finiscono in OpenAPI così tutti possono usarli.

Copia link a questa sezioneVantaggi per il vostro progetto

  • Un contratto: OpenAPI + riferimento API, niente reverse engineering dell'interfaccia
  • Piattaforma headless: Tillor come backend per front-end, portale o app mobile
  • Eventi pronti all'uso: saltate il polling quando webhook o SSE bastano
  • Locale + cloud: Connector per hardware on-prem, API per sistemi centrali
  • Docs per AI e codegen: documentazione sviluppatori e llms-full.txt per il tooling

Copia link a questa sezioneCome appare agli integratori

Ogni integrazione parte da una chiave API: aprite il menu utente (evidenziato 1) e andate a Chiavi API (evidenziato 2).

Autenticazione, header org, rate limit, webhooks ed esempi di codice sono in HTTP API, Webhooks ed Esempi. Provate gli endpoint nel riferimento API o via OpenAPI.


Costruite su Tillor? Richiedete una demo e rivediamo insieme OpenAPI, eventi e il vostro caso d'uso.