Mews koppelen aan je website.

Mews is een cloudplatform voor gastvrijheid: een property management systeem met daaromheen betalingen, kassasoftware, een boekingsmodule en een marktplaats met koppelingen. Het wordt gebruikt door hotels, hostels, appartementen en verblijfsaccommodaties.

Voor een koppeling is het belangrijkste dat Mews niet één API heeft maar vijf, elk met een eigen doel. De Connector API is de algemene, voor toegang tot gegevens en diensten in Mews Operations. De Booking Engine API is er voor boekingsmodules, zodat een gast rechtstreeks in Mews reserveert. De Channel Manager API is voor distributiepartijen en reisplatforms, de POS API voor kassasystemen, en de Loyalty Partner API voor loyaliteitsprogramma’s.

De documentatie staat openbaar, per API met een eigen set richtlijnen en een volledige operatiereferentie, elk in een publieke GitHub-repository. Er is een llms.txt en je kunt elke pagina als markdown ophalen.

Deze vraag komt eerst, en Mews beantwoordt hem zelf in hun documentatie.

Wil je dat een bezoeker op jouw site een kamer of plek boekt en dat die reservering meteen in Mews staat, dan is dat de Booking Engine API. Die is ontworpen om rechtstreeks vanuit de browser te worden aangeroepen.

Wil je gegevens uit Mews halen om er pagina’s van te maken, of iets terugschrijven vanaf je server, dan is dat de Connector API. Daar zitten reserveringen, profielen, diensten, tarieven, apparaten en de rest in, met gebruiksscenario’s die van kiosk tot upselling lopen.

In de praktijk gebruik je ze vaak allebei: de Connector voor de inhoud van je pagina’s en de Booking Engine voor de boekingsstap zelf. Wat je niet moet doen is de Booking Engine vanaf je server blijven bevragen; die heeft bescherming tegen scrapen en zulke aanvragen kunnen falen.

De Connector API werkt met twee tokens die je in de body van de aanvraag meestuurt, niet in een header. Het ClientToken hoort bij jouw toepassing en blijft hetzelfde. Het AccessToken hoort bij de verbinding met één locatie, of bij meerdere tegelijk als het een portfolio-token is. Voor elke omgeving krijg je een andere set.

Op de demo-omgeving staan openbare tokens in de documentatie, met de uitdrukkelijke waarschuwing dat daar geen echte gegevens in horen. Voor productie doorloop je eerst het certificeringstraject; daarna wordt er per locatie die verbinding wil maken een AccessToken aangemaakt.

Bijblijven kan op twee manieren: webhooks, waarbij Mews jouw endpoint aanroept als er iets gebeurt, of WebSockets, voor een open verbinding. Allebei zijn ze beter dan blijven vragen.

De boekingsmodule is één stap in een veel langer proces. Iemand zoekt, vergelijkt, leest over de omgeving, kijkt naar foto’s en beslist daarna pas. Dat hele voortraject staat op je eigen site, en daar valt de winst te halen.

Wij bouwen per kamertype of accommodatie een eigen pagina op je eigen adres, met de omschrijving, de voorzieningen en de foto’s uit Mews, plus de tekst die je zelf toevoegt: de buurt, het ontbijt, de parkeerregeling. Zo is er iets te vinden voor iemand die zoekt op jouw type verblijf in jouw plaats, en dat is met een boekingsmodule alleen niet zo.

Daarbovenop de meting. Met webhooks weten we wanneer een reservering binnenkomt, en dat is te koppelen aan de pagina waar de bezoeker vandaan kwam. Dat cijfer is het verschil tussen gokken en weten welke pagina’s hun werk doen.