Koppelingen in GlamWorx

GlamWorx heeft een eigen API: een beveiligde technische laag waarmee andere applicaties gegevens kunnen uitwisselen met GlamWorx. Denk aan een boekhoudpakket, een e-mailtool of een systeem van je eigen IT-leverancier.

Op basis van deze laag bouwt je software-leverancier of IT-dienstverlener de specifieke koppeling die jij nodig hebt - bijvoorbeeld met jouw boekhoudpakket.

Eenmaal gebouwd, zorgt zo'n koppeling er bijvoorbeeld voor dat afspraken en omzet automatisch worden doorgestuurd naar je boekhoudpakket, of dat een marketingtool verjaardagen van klanten ophaalt om op tijd een kaartje te sturen.

Voor elke koppeling maak je in de instellingen een eigen digitale sleutel aan, die je alleen deelt met de partij die de koppeling bouwt. Zonder die sleutel kan niemand bij jouw gegevens.

Je bepaalt zelf precies waar een sleutel toegang toe geeft - bijvoorbeeld alleen tot afspraken, en niet tot financiële gegevens. Werkt een koppeling niet meer zoals bedoeld, of stopt de samenwerking met een leverancier? Dan trek je de sleutel met één klik weer in, en werkt hij per direct nergens meer.

Met webhooks laat GlamWorx een koppeling direct weten wanneer een afspraak wordt gemaakt, gewijzigd of geannuleerd - de koppeling hoeft dus niet steeds zelf te kijken of er iets nieuws is.

Zo'n melding bevat alleen wat er gebeurde en om welke afspraak het gaat, geen klantgegevens. De koppeling haalt de afspraak daarna zelf veilig op. Je stelt webhooks in onder Instellingen, stuurt met één klik een testbericht en ziet per melding of hij is afgeleverd.

Bouw je deze koppeling voor een salon die met GlamWorx werkt? De API is een REST API, beveiligd met OAuth 2.0 (client credentials grant): een kortlevend access token dat je ververst met een refresh token, zonder het client secret opnieuw te versturen.

Webhooks zijn ondertekend met HMAC-SHA256 en worden bij een fout automatisch opnieuw verstuurd. Met ?updated_since haal je alleen op wat er sinds de vorige keer veranderd is, inclusief verwijderingen. Transacties bevatten de bonregels, de btw per tarief en alle (deel)betalingen.

Alle endpoints, schema's en foutcodes staan overzichtelijk in de Swagger-documentatie, inclusief een "Try it out" om direct requests te testen. Bekijk de API-documentatie.