Probleme mit API-Schlüsseln

Die API antwortet mit 401 oder 429, ein Schlüssel ist verloren oder wurde versehentlich geteilt.

API-Schlüssel legst du unter API Key an. Ein Schlüssel hat die Form bhomy_live_sk_ gefolgt von 48 Zeichen und wird im Header Authorization: Bearer … mitgeschickt.

Die API antwortet mit 401

code in der AntwortBedeutungLösung
auth.missing_headerDer Header Authorization fehltSchick den Header bei jeder Anfrage mit
auth.invalid_typeDer Header beginnt nicht mit BearerSchreib Authorization: Bearer bhomy_live_sk_… mit Leerzeichen nach Bearer
auth.invalid_keyDen Schlüssel gibt es nicht, oder er ist unvollständigPrüfe, ob er vollständig kopiert ist, ohne Leerzeichen oder Zeilenumbruch am Ende
auth.key_revokedDer Schlüssel ist deaktiviertReaktiviere ihn unter API Key mit Reaktivieren oder nutze einen anderen

Die API antwortet mit 429

error in der AntwortBedeutungLösung
rate_limit_exceededMehr als 60 Anfragen in 60 Sekunden, je Schlüssel und je IP-Adresse. limit_scope sagt, welche Grenze griffWarte die Sekunden aus dem Header Retry-After ab und verteile deine Anfragen
concurrent_limit_reachedAlle Leitungen deines Tarifs sind belegtWarte die Sekunden aus Retry-After ab und versuch es erneut

Der Schlüssel ist verloren

Ein Schlüssel wird nur einmal angezeigt, direkt nach dem Anlegen. Wir speichern ihn nur als Prüfwert und können ihn nicht wieder anzeigen. Lege einen neuen Schlüssel an, trag ihn in deinem Werkzeug ein und lösche danach den alten.

Der Schlüssel wurde geteilt oder ist öffentlich

  1. Öffne API Key und klicke beim betroffenen Schlüssel auf Deaktivieren. Ab sofort wird er abgewiesen.
  2. Lege einen neuen Schlüssel an und trag ihn in deinen Werkzeugen ein.
  3. Lösche den alten Schlüssel, sobald alles wieder läuft.
  4. Prüfe im Anrufverlauf, ob ausgehende Anrufe stattfanden, die du nicht ausgelöst hast.

Weiterhilfe

Schick uns den Namen des Schlüssels oder den Schlüssel-Hinweis aus API Key, den Zeitpunkt der Anfrage und die Antwort der API, siehe Problem melden. Den vollständigen Schlüssel brauchen wir nie.