Authentifizierung
API-Schlüssel, Berechtigungen und getrennte Umgebungen.
Auf dieser Seite
Serverseitiger API-Zugang
Jede Anfrage an API v1 benötigt einen Bearer-Schlüssel. Sitzungscookies aus der App berechtigen nicht zu API-Aufrufen.
Authorization: Bearer rbx_test_…Verwenden Sie Schlüssel ausschließlich auf dem Server. Speichern Sie sie nicht im Frontend, in mobilen Apps, öffentlichen Beispielen oder im Quellcode.
Berechtigungen passend vergeben
| Recht | Verwendung |
|---|---|
| Read · Lesen | Dokumente, Artefakte, Jobstatus, Anfrageverlauf und Zustellverlauf lesen. |
| Process · Parsen / Prüfen | Dokumente auslesen und technisch validieren. |
| Generate · Erzeugen | XRechnung oder ZUGFeRD aus strukturierten Daten erzeugen. |
| Alle drei Rechte | Konvertierungsprüfungen, ausdrückliche Konvertierungsbestätigung und manuelle Retry-Endpunkte. |
Hintergrundaufträge benötigen zusätzlich zum jeweiligen Aktionsrecht immer Read. Der Beispiel-Webhook-Receiver benötigt nur einen Schlüssel mit Leserecht.
Sandbox und Live
| Umgebung | Basis-URL | Schlüssel |
|---|---|---|
| Sandbox | /api/v1/sandbox | rbx_test_… |
| Live | /api/v1/live | rbx_live_… |
Schlüssel, Dokumente, Idempotenz, Limits, Aufträge und Webhook-Empfänger sind getrennt. Erzeugte Sandbox-Rechnungen erhalten eine TEST-Nummer und einen Testhinweis. Hochgeladene Originaldateien bleiben unverändert.
Auch Sandbox-Ereignisse werden an echte Empfänger zugestellt, wenn der Betreiber Webhooks:CaptureOnly=false eingestellt hat.
Schlüssel verwalten
Inhaber und Administratoren erstellen, befristen und widerrufen Schlüssel unter Integration → Entwickler · API & Sandbox. Der vollständige Schlüssel wird einmal angezeigt; Rebilix speichert dessen Hash.
Ablauf, Widerruf, Kontosperre, ein geänderter Sicherheitsstempel oder der Verlust der Administratorberechtigung des Erstellers sperren den Zugriff. Neue Hintergrundverarbeitung und Dokument-Commit prüfen diese Berechtigung erneut. Bereits gespeicherte Originale werden dadurch nicht gelöscht.