API & Webhooks

Wat de Salonnare API en webhooks zijn, waarvoor je ze gebruikt en hoe je API-sleutels en webhooks aanmaakt.

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.

Nog niet beschikbaar

Deze functie staat in de app nog op Binnenkort: je kunt op dit moment geen API-sleutels of webhooks aanmaken. Open je Instellingen > API & Webhooks, dan zie je alleen een melding dat de functie eraan komt. Deze pagina beschrijft hoe het gaat werken zodra de functie beschikbaar is.

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 het tabblad API-sleutels op Nieuwe sleutel.
  3. Geef de sleutel een herkenbare naam (bijvoorbeeld "Boekhouding") en kies de rechten: Alleen lezen, Lezen + schrijven of Volledige toegang. Op dit moment kan een API-sleutel altijd alleen gegevens ophalen, ongeacht welk rechtenniveau je kiest; een sleutel met alleen-lezen rechten kan sowieso nooit meer dan dat.
  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 deze zes gebeurtenissen versturen:

  • booking.created -- een medewerker maakt een afspraak in de app
  • booking.updated -- een medewerker wijzigt een afspraak in de app (ook een statuswijziging naar voltooid of no-show)
  • booking.cancelled -- een medewerker annuleert een afspraak in de app
  • payment.received -- een medewerker rekent af in de kassa
  • client.created -- een medewerker maakt een klant aan in de app
  • client.updated -- een medewerker wijzigt klantgegevens in de app
Alleen wat in de app gebeurt

Elke gebeurtenis komt uit een handeling van een medewerker in de app. Een online boeking via je boekingspagina of Google, een klant die zelf annuleert, een wachtlijst die omgezet wordt, een herhalende reeks, een kuur en een klant die zichzelf op de boekingspagina aanmaakt sturen (nog) geen melding. Bespreek dat met je koppelpartij: die kan de gemiste afspraken opvangen door periodiek de afsprakenlijst op te halen.

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.

Het geheim (secret) waarmee Salonnare de berichten ondertekent, wordt getoond zodra je de webhook opslaat -- bewaar dat net als een API-sleutel meteen ergens veilig, want Salonnare toont het niet nogmaals. Ben je het kwijt, klik dan bij de webhook op het ververs-pictogram (Nieuw geheim aanvragen); je krijgt dan eenmalig een nieuw geheim te zien. Het oude geheim werkt vanaf dat moment niet meer, dus moet de ontvangende kant ook worden bijgewerkt.

Elke webhook-melding is voorzien van een handtekening waarmee de ontvanger kan controleren dat het bericht echt van Salonnare komt.

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.

Ben je developer en zoek je de technische details (authenticatie, endpoints, velden, foutcodes, handtekeningverificatie)? Bekijk de API Reference -- die pagina is in het Engels, omdat hij voor ontwikkelaars is geschreven.

Gerelateerde artikelen

InstellingenOnline boekingenMeldingen