Developers
OpenAPI ↗
Zur App
Dokumentation / Einstieg
API v1 · Einstieg

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.

HTTP
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

RechtVerwendung
Read · LesenDokumente, Artefakte, Jobstatus, Anfrageverlauf und Zustellverlauf lesen.
Process · Parsen / PrüfenDokumente auslesen und technisch validieren.
Generate · ErzeugenXRechnung oder ZUGFeRD aus strukturierten Daten erzeugen.
Alle drei RechteKonvertierungsprü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

UmgebungBasis-URLSchlüssel
Sandbox/api/v1/sandboxrbx_test_…
Live/api/v1/liverbx_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.

Sandbox ist keine Versandsperre für Webhooks.

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.

Verbindung wird wiederhergestellt …

Neuer Verbindungsversuch in Sekunden.

Die Verbindung konnte nicht wiederhergestellt werden.
Bitte versuchen Sie es erneut oder laden Sie die Seite neu.

Ihre Sitzung wurde pausiert.

Die Sitzung konnte nicht fortgesetzt werden.
Bitte versuchen Sie es erneut oder laden Sie die Seite neu.