API-Schlüssel
Mit einem API-Schlüssel können externe Anwendungen (z. B. Ihre Branchen-Software) über die flstr-Schnittstelle Rechnungen in Ihrem Konto erstellen — ohne dass sich jemand einloggen muss.
API-Schlüssel sind ab dem Basic-Tarif verfügbar. Im Free-Tarif ist die Erstellung gesperrt.
Was ein Schlüssel ist
- Ein Schlüssel gewährt Schreibzugriff auf Ihr Konto (Rechnungen anlegen und festschreiben) — behandeln Sie ihn wie ein Passwort.
- Ein Konto kann mehrere Schlüssel tragen — etwa je einen pro angebundener Anwendung. So können Sie einen einzelnen Schlüssel widerrufen, ohne die anderen zu beeinträchtigen.
- Der Schlüssel wird genau einmal bei der Erstellung angezeigt und danach nie wieder. flstr speichert nur einen verschlüsselten Abdruck, nie den Schlüssel selbst.
Erstellen
- Konto → API-Schlüssel öffnen (nur Inhaber oder Admin).
- Einen Namen vergeben (z. B. „Lohnport”) — so erkennen Sie später, welche Anwendung welchen Schlüssel nutzt.
- Schlüssel erstellen — den angezeigten Schlüssel sofort kopieren und sicher in der externen Anwendung hinterlegen.
Ein Schlüssel beginnt mit flstr_live_.
Widerrufen
Über Widerrufen in der Liste wird ein Schlüssel sofort ungültig — Anwendungen, die ihn nutzen, verlieren umgehend den Zugriff. Ein Widerruf ist endgültig; erstellen Sie bei Bedarf einen neuen Schlüssel. Widerrufene Schlüssel bleiben aus Nachvollziehbarkeitsgründen in der Liste sichtbar.
Wird Ihr Konto auf Free herabgestuft, lehnt die Schnittstelle jede Anfrage ab (auch mit einem bestehenden Schlüssel), bis wieder ein zahlender Tarif aktiv ist. Der Schlüssel bleibt erhalten und funktioniert nach dem erneuten Upgrade wieder.
Die technische Referenz der Endpunkte (Felder, Beispiel-Requests, Fehlercodes) für Entwickler steht unter API für Entwickler.