API & Webhooks

Met de API en webhooks van Salonnare koppel je je salon aan andere software. Denk aan je boekhoudpakket, een eigen website, een nieuwsbriefdienst of een zelfgebouwd dashboard. Je hoeft geen developer te zijn om te begrijpen wat ze doen -- deze pagina legt het rustig uit.

Wat is een API?

Een API (Application Programming Interface) is een afspraak waarmee twee programma's met elkaar praten. Waar jij in de app op een knop klikt om een afspraak op te halen, kan een ander programma dezelfde gegevens opvragen via de API -- automatisch en zonder tussenkomst.

Praktische voorbeelden voor een salon:

• Je boekhoudprogramma haalt elke nacht automatisch je omzet op.
• Je eigen website toont je diensten en prijzen, rechtstreeks uit Salonnare.
• Een koppelpartij synchroniseert je klantenbestand.

Toegang tot de API verloopt via een API-sleutel: een geheime code die bewijst dat de aanvraag van jou komt. Behandel die sleutel als een wachtwoord.

Een API-sleutel aanmaken

1. Ga naar Instellingen -> API & Webhooks.
2. Klik op Nieuwe API-sleutel.
3. Geef de sleutel een herkenbare naam (bijvoorbeeld "Boekhouding") en kies de rechten: alleen-lezen of lezen en schrijven.
4. Kopieer de sleutel meteen en bewaar hem veilig. Om veiligheidsredenen toont Salonnare de volledige sleutel maar één keer.

Vermoed je dat een sleutel is uitgelekt? Verwijder hem dan direct -- alle koppelingen met die sleutel stoppen dan meteen.

Wat is een webhook?

Een webhook is het omgekeerde van de API. In plaats van dat jij gegevens ophaalt, stuurt Salonnare automatisch een bericht naar een adres (URL) van jou zodra er iets gebeurt. Zo hoeft de andere software niet steeds te vragen "is er al iets nieuws?" -- ze krijgt vanzelf een seintje.

Salonnare kan onder meer deze gebeurtenissen versturen:

• booking.created -- er is een nieuwe afspraak gemaakt
• booking.updated -- een afspraak is gewijzigd
• booking.cancelled -- een afspraak is geannuleerd
• payment.received -- er is een betaling ontvangen
• client.created -- er is een nieuwe klant aangemaakt
• client.updated -- klantgegevens zijn gewijzigd

Een webhook instellen

1. Ga naar Instellingen -> API & Webhooks en open het tabblad Webhooks.
2. Klik op Nieuwe webhook.
3. Vul de URL in waar Salonnare de meldingen naartoe stuurt (die krijg je van je koppelpartij of developer).
4. Kies de gebeurtenissen waarop je wilt reageren.
5. Bewaar. Je kunt daarna de verzendlogs bekijken om te zien of de meldingen goed aankomen.

Veilig werken

• Deel API-sleutels nooit publiekelijk (niet in e-mail, screenshots of code die online staat).
• Geef een koppeling alleen de rechten die ze echt nodig heeft -- kies alleen-lezen waar dat kan.
• Verwijder sleutels en webhooks die je niet meer gebruikt.

Omdat Salonnare je data in de EU verwerkt en je zelf bepaalt welke koppelingen toegang krijgen, houd je volledige controle over je gegevens. Heb je hulp nodig bij een koppeling? Neem gerust contact op via de supportpagina.