API & Webhooks

Mit der API und Webhooks von Salonnare verbindest du deinen Salon mit anderer Software: deinem Buchhaltungsprogramm, deiner eigenen Website, einem Newsletter-Dienst oder einem selbst gebauten Dashboard. Du musst kein Entwickler sein, um zu verstehen, was sie tun -- diese Seite erklärt es in Ruhe.

Was ist eine API?

Eine API (Application Programming Interface) ist eine Vereinbarung, über die zwei Programme miteinander sprechen. Wo du in der App auf einen Knopf klickst, um einen Termin zu laden, kann ein anderes Programm dieselben Daten über die API abrufen -- automatisch und ohne manuelle Schritte.

Praktische Beispiele für einen Salon:

• Deine Buchhaltungssoftware ruft jede Nacht automatisch deinen Umsatz ab.
• Deine eigene Website zeigt deine Leistungen und Preise direkt aus Salonnare.
• Ein Integrationspartner synchronisiert deine Kundenliste.

Der Zugriff auf die API läuft über einen API-Schlüssel: einen geheimen Code, der beweist, dass die Anfrage von dir kommt. Behandle ihn wie ein Passwort.

Einen API-Schlüssel anlegen

1. Gehe zu Einstellungen -> API & Webhooks.
2. Klicke auf Neuer API-Schlüssel.
3. Gib dem Schlüssel einen erkennbaren Namen (zum Beispiel "Buchhaltung") und wähle die Rechte: nur lesen oder lesen und schreiben.
4. Kopiere den Schlüssel sofort und bewahre ihn sicher auf. Aus Sicherheitsgründen zeigt Salonnare den vollständigen Schlüssel nur einmal an.

Vermutest du, dass ein Schlüssel geleakt ist? Lösche ihn sofort -- jede Integration mit diesem Schlüssel wird umgehend gestoppt.

Was ist ein Webhook?

Ein Webhook ist die Umkehrung der API. Statt dass du Daten abrufst, sendet Salonnare automatisch eine Nachricht an eine Adresse (URL) von dir, sobald etwas passiert. Die andere Software muss nicht mehr ständig fragen "gibt es etwas Neues?" -- sie bekommt von selbst ein Signal.

Salonnare kann unter anderem diese Ereignisse senden:

• booking.created -- ein neuer Termin wurde erstellt
• booking.updated -- ein Termin wurde geändert
• booking.cancelled -- ein Termin wurde storniert
• payment.received -- eine Zahlung ist eingegangen
• client.created -- ein neuer Kunde wurde angelegt
• client.updated -- Kundendaten wurden geändert

Einen Webhook einrichten

1. Gehe zu Einstellungen -> API & Webhooks und öffne den Tab Webhooks.
2. Klicke auf Neuer Webhook.
3. Trage die URL ein, an die Salonnare die Benachrichtigungen sendet (die bekommst du von deinem Integrationspartner oder Entwickler).
4. Wähle die Ereignisse, auf die du reagieren möchtest.
5. Speichere. Danach kannst du die Versandprotokolle prüfen, um zu sehen, ob die Benachrichtigungen korrekt ankommen.

Sicher arbeiten

• Teile API-Schlüssel niemals öffentlich (nicht in E-Mails, Screenshots oder online veröffentlichtem Code).
• Gib einer Integration nur die Rechte, die sie wirklich braucht -- wähle nur lesen, wo möglich.
• Lösche Schlüssel und Webhooks, die du nicht mehr nutzt.

Da Salonnare deine Daten in der EU verarbeitet und du selbst entscheidest, welche Integrationen Zugriff erhalten, behältst du die volle Kontrolle über deine Daten. Brauchst du Hilfe bei einer Integration? Melde dich gerne über die Support-Seite.