API-first recreatieparksoftware: Tillor als headless platform

Een API is de manier waarop een ander programma met Tillor praat: uw website, boekhoudpakket of eigen app kan reserveringen en facturen opvragen zonder iemand de Tillor-balie te laten openen. OpenAPI is de officiële lijst van wat daarin kan; webhooks zijn automatische seintjes wanneer er iets gebeurt, bijvoorbeeld factuur betaald.

Recreatieparken draaien zelden op één standaardpakket. Als recreatieparksoftware moet Tillor ook als backend dienen voor uw eigen website, boekingswidget of BI.

U heeft een CRM, een boekhoudpakket, soms hardware op het terrein. Tillor is gebouwd met integrators in gedachten: de webapp is één client op dezelfde API die u als partner ook gebruikt.

Wij willen dat u workflows kunt bouwen zonder workarounds. Daarom publiceren we elke organisatie-endpoint in OpenAPI, leveren we webhooks en SSE voor events, en ondersteunen we MQTT waar pub/sub beter past. Mist u iets voor een serieuze koppeling? Bespreek het met ons: standaard CRUD op kernentiteiten is het uitgangspunt, en we kunnen endpoints uitbreiden waar uw use case dat rechtvaardigt.

#Link naar deze sectie kopiërenScenario's voor integrators

Eigen boekingswidget. Uw website post reserveringen rechtstreeks naar Tillor, leest beschikbaarheid via list-endpoints en stuurt bevestigingsmails vanuit uw eigen stack. Tillor blijft bron voor bezettingen en facturatie.

Datawarehouse of BI. 's Nachts haalt een job klanten, openstaande facturen en meterstanden op via paginated list-calls. Geen CSV-export die veroudert; u leest dezelfde velden als de balie.

Event-gedreven koppeling. Bij factuur betaald of klant aangemaakt triggert een webhook uw middleware. Liever een open stream? SSE levert dezelfde event keys live.

Hardware op het terrein. Slagbomen, printers en identiteitslezers praten lokaal via de Connector; uw cloud integratie blijft op HTTP en events.

#Link naar deze sectie kopiërenCRUD op kernentiteiten

Voor elke basis entiteit in Tillor is het doel helder: u moet records kunnen listen, lezen, aanmaken, bijwerken en verwijderen via HTTP, zonder de UI te openen.

Concreet betekent dat per org-pad onder /api/orgs/{orgId}/...:

Actie	Typische HTTP-methode
List (met paginering en filters)	GET op de collection
Read	GET op {id}
Create	POST
Update	PATCH of PUT (partial vs volledige replace, per entiteit in OpenAPI)
Delete	DELETE

Vandaag de dag zijn klanten, bezettingen, facturen, producten, meters en taken op dat patroon aangesloten. Reserveringen en terreinen volgen dezelfde lijn; check OpenAPI voor de actuele set methodes per resource.

Workflow-acties (check-in, factuur boeken, verlengen) krijgen een expliciet endpoint in plaats van een verborgen schermactie. Zo blijft uw integratie stabiel als de UI evolueert.

#Link naar deze sectie kopiërenFlexibiliteit en uitbreiding

Tillor is geen gesloten eiland. Wij willen dat partners Tillor in bestaande landschappen plaatsen:

• Standaard REST met Zod-geschematiseerde input en output in OpenAPI
• Org-scoped URLs en headers (x-api-key, X-Tillor-Org-Id) zoals beschreven in HTTP API
• Rate limits die integraties kunnen plannen (5000 requests per 60 seconden per sleutel)
• Zelfde events via webhook, SSE of MQTT, afhankelijk van wat uw stack het best verwerkt

Heeft u een koppeling die een extra list-filter, bulk-actie of ontbrekende delete nodig heeft? Op aanvraag spreken we uitbreidingen af zolang ze passen bij het datamodel en andere klanten er baat bij hebben. Liever geen maatwerk in het geheim: nieuwe endpoints landen in OpenAPI zodat iedereen ze kan gebruiken.

#Link naar deze sectie kopiërenVoordelen voor uw project

• Eén contract: OpenAPI + API-referentie, geen reverse-engineering van de UI
• Headless platform: Tillor als backend voor uw front-end, portal of mobiele app
• Events out of the box: geen polling als webhook of SSE volstaat
• Lokaal + cloud: Connector voor on-prem hardware, API voor centrale systemen
• Documentatie voor AI en codegen: ontwikkelaars-docs en llms-full.txt voor tooling

#Link naar deze sectie kopiërenZo ziet het eruit voor integrators

Elke koppeling begint met een API-sleutel: open het gebruikersmenu (markering 1) en ga naar API-sleutels (markering 2).

Authenticatie, org-headers, rate limits, webhooks en codevoorbeelden staan in HTTP API, Webhooks en Voorbeelden. Probeer endpoints in de API-referentie of via OpenAPI.

---

Bouwt u aan een koppeling met Tillor? Vraag een demo aan en we lopen OpenAPI, events en uw use case door.