System

API-Zugang einrichten

Für Kasse und Webshop

Wie Sie einen API-Schlüssel erstellen, damit Ihr Kassensystem, Ihre Website oder ein anderes Programm direkt mit felizzio arbeiten kann.

Über die Schnittstelle (API) tauschen andere Programme Daten mit felizzio aus. So prüft zum Beispiel Ihr Kassensystem einen Gutschein und löst ihn direkt ein, ohne dass jemand felizzio öffnen muss. Für den Zugriff braucht das Programm einen API-Schlüssel. Diesen erstellen Sie im Menü unter System → Schnittstellen → API Zugang. Die Seite besteht aus der Dokumentation und der Liste Ihrer API-Schlüssel.

Den API-Zugang verwenden Sie hauptsächlich bei, …

  • einer Anbindung an Ihr Kassensystem
  • einer Verbindung zu Ihrem Hotel- oder Reservationssystem
  • Gutscheinen, die automatisch aus einem anderen Programm erstellt werden sollen
  • einer eigenen Auswertung Ihrer Gutscheindaten

Was die API kann

Möglichkeiten

Mit einem API-Schlüssel kann ein anderes Programm unter anderem:

  • Gutscheine lesen und prüfen: Zum Beispiel Wert, Restguthaben, Gültigkeit und Bezahlstatus eines Gutscheins abfragen.
  • Gutscheine einlösen: Einen Betrag entwerten und eine Entwertung wieder rückgängig machen.
  • Gutscheine erstellen und ändern: Neue Gutscheine ausstellen, bestehende anpassen oder löschen.
  • Gutschein-Arten verwalten: Gutschein-Arten abfragen, erstellen und ändern.

Welche Funktionen Ihr Programm nutzt, hängt von dessen Anbieter ab. Fragen Sie dort nach, ob eine Anbindung an felizzio möglich ist.

Mehrwert: Mit einer Anbindung an Ihre Kasse lösen Sie Gutscheine dort ein, wo Sie ohnehin abrechnen. Die Entwertung ist sofort in felizzio sichtbar, und niemand muss Beträge doppelt erfassen.

API-Schlüssel erstellen

Schlüssel erstellen

Klicken Sie unter API Zugang auf «API Schlüssel hinzufügen» und erfassen Sie einen Titel, zum Beispiel «Kassensystem» oder «Webshop». So sehen Sie später, wofür der Schlüssel verwendet wird. Nach dem Speichern erscheint der Schlüssel in der Liste, mit Titel, Benutzer und Datum.

Erstellen Sie für jedes Programm einen eigenen Schlüssel. So können Sie einen Zugang später entfernen, ohne die anderen zu stören.

Schlüssel anzeigen und kopieren

In der Liste sehen Sie nur den Anfang des Schlüssels. Mit «API Schlüssel anzeigen» und Ihrem Passwort sehen Sie den ganzen Schlüssel. Mit «In Zwischenablage kopieren» übernehmen Sie ihn und geben ihn an den Anbieter Ihres Programms weiter.

Achtung: Wer den Schlüssel kennt, hat vollen Zugriff auf Ihre Gutscheine, auch zum Einlösen und Löschen. Geben Sie ihn nur an vertrauenswürdige Partner weiter, nie per Chat oder in einer öffentlichen Datei, und niemals im Code Ihrer Website.

Schlüssel bearbeiten oder entfernen

Bearbeiten und entfernen

Bearbeiten

Mit «Bearbeiten» ändern Sie den Titel. Der Schlüssel selbst bleibt gleich.

Entfernen

Mit «Entfernen» löschen Sie einen Schlüssel nach einer Sicherheitsfrage. Programme, die diesen Schlüssel verwenden, haben danach sofort keinen Zugriff mehr. Derselbe Schlüssel lässt sich nicht wiederherstellen, Sie können aber jederzeit einen neuen erstellen.

Tipp: Wechseln Sie das Kassensystem oder endet eine Zusammenarbeit, entfernen Sie den Schlüssel. Vermuten Sie, dass jemand Unbefugtes ihn kennt, erstellen Sie einen neuen und entfernen Sie den alten.

Für Ihre Webagentur oder Ihren Kassenanbieter

Technische Angaben

Mit «API Dokumentation anzeigen» öffnen Sie die technische Beschreibung aller Funktionen. Mit «PHP Client Library» laden Sie eine fertige Programmbibliothek herunter. Die wichtigsten Angaben auf einen Blick:

  • Adresse: https://www.felizzio.com/api/v1
  • Anmeldung: Der API-Schlüssel wird als HTTP-Header Key oder als Parameter key mitgeschickt.
  • Format: JSON, Meldungen der Schnittstelle auf Englisch.
  • Grenze: Bis zu 100 Anfragen pro Minute.

Wer API-Schlüssel verwalten darf

Berechtigungen

Den API Zugang sehen und verwalten nur Administrator:innen. Jeder Schlüssel ist mit der Person verknüpft, die ihn erstellt hat. Diese steht in der Spalte «Benutzer».

Andere suchten auch:

API, Schnittstelle, REST, RESTful, API Zugang, API Schlüssel, API-Key, Key, Kassensystem, Kasse, POS, Anbindung, Integration, Hotelsystem, Reservationssystem, API Dokumentation, PHP Client Library, Entwickler, Webagentur, Schlüssel anzeigen, Schlüssel entfernen, OpenAPI

Sieht Ihre Oberfläche etwas anders aus?

felizzio wird kontinuierlich weiterentwickelt. Kleinere Änderungen an der Benutzer­oberfläche oder neue Funktionen werden automatisch für alle Kunden bereitgestellt. Die beschriebenen Abläufe bleiben dabei grundsätzlich gleich oder sehr ähnlich. Wenden Sie sich bei Fragen gerne an unseren Support.

Zuletzt aktualisiert für Version 1.10 (Oktober 2026)