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.

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}/...:
| Azione | Metodo HTTP tipico |
|---|---|
| Elenco (paginazione e filtri) | GET sulla collection |
| Lettura | GET su {id} |
| Creazione | POST |
| Aggiornamento | PATCH o PUT (parziale vs sostituzione completa, per entità in OpenAPI) |
| Eliminazione | DELETE |
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.txtper 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.
Altro dal blog

✨ Camping Vlasaard ha scelto il software parco ricreativo: dal carta a una piattaforma unica
Come Vlasaard NV ha scelto il software per campeggi per sostituire carta, fogli di calcolo e strumenti separati con una piattaforma unica per sbarre KC80, contatori LoRa, elettricità ICY e pagamenti Mollie.

Docce prepagate in campeggio: doccia e porta con un solo tag NFC
Un sistema di docce prepagate per il vostro campeggio: doccia e porta con un braccialetto NFC o un portachiavi, lavatrici avviate con un codice QR.

Campi personalizzati nel software per campeggi: cliente e piazzola
Registrate ciò che il vostro campeggio deve sapere, dalla targa del rimorchio al numero dell'armadio elettrico, con i campi personalizzati del software per campeggi.