api_schluessel_ungueltigSchnittstelle
Schlüssel unbekannt
HTTP 401 der Schnittstelle: Der mitgeschickte Schlüssel gehört zu keinem aktiven Zugang — er wurde gesperrt, gehört zu einem anderen Konto oder ist beim Einfügen beschädigt worden. Leg im Portal einen neuen an; ein gesperrter Schlüssel lässt sich nicht wiederbeleben.
Wortlaut der Meldung
[api_schluessel_ungueltig] Dieser Zugangsschlüssel ist unbekannt oder gesperrt. Lege in den Einstellungen unter Schnittstelle einen neuen an.
Stand: Juli 2026 · Geprüft und geschrieben von Pascal Wagner
Warum das passiert
- Der Schlüssel wurde im Portal gesperrt — Sperren ist endgültig, damit die Protokollspur erhalten bleibt.
- Beim Kopieren wurde der Schlüssel gekürzt oder um Leerzeichen ergänzt. Er beginnt mit rl_live_ und ist rund 50 Zeichen lang; er wird genau einmal angezeigt.
- Der Schlüssel stammt aus einem anderen Konto oder von einem anderen Betrieb — jeder Schlüssel gehört zu genau einem Betrieb.
So behebst du es
- Leg im Portal unter Einstellungen → Schnittstelle einen neuen Schlüssel an und kopiere ihn vollständig, ohne Umbruch und ohne Leerzeichen.
- Trag ihn in den Einstellungen des Plugins ein und nutze den Verbindungstest — er zeigt bei Erfolg Betriebsname und Tarif.
- Sperr den alten Zugang, sobald der neue läuft.
Was die Regel nicht prüft
Nach 30 Fehlversuchen je Stunde und Absenderadresse antwortet die Schnittstelle mit 429 rate_limited — ein Plugin, das mit einem ungültigen Schlüssel im Minutentakt weiterprobiert, sperrt sich für den Rest der Stunde selbst aus. Erst den Schlüssel richten, dann wiederholen.
Tritt oft zusammen auf mit
- api_schluessel_abgelaufen — Schlüssel abgelaufen
- api_recht_fehlt — Recht fehlt am Schlüssel
- rate_limited — Zu viele Aufrufe in kurzer Zeit
Quelle: die Schnittstelle des Rechnungslotsen (/api/v1). Diese Seite beschreibt das dokumentierte Verhalten des Dienstes und ist keine Rechts- oder Steuerberatung. Fehlt etwas oder stimmt etwas nicht? Schreib uns.