Authentifizierung
Jede Anfrage trägt den API-Schlüssel als Bearer-Token.
Jede Anfrage an /v1 braucht deinen Schlüssel in der Kopfzeile Authorization:
Kopfzeile
Authorization: Bearer fx_live_…Schlüssel verwalten
In der Konsole legst du Schlüssel an, benennst sie und widerrufst sie. Wir speichern nur einen Hash, den Schlüssel selbst siehst du ein einziges Mal beim Anlegen. Ist er weg, widerruf ihn und leg einen neuen an.
Ein widerrufener Schlüssel ist bei der nächsten Anfrage ungültig. Es gibt keinen Zwischenspeicher, der ihn noch eine Weile weiterleben lässt.
Jedes Konto hat höchstens 5 aktive Schlüssel und kann im Monat 10 neue anlegen. Jeder Schlüssel gilt für alle Modelle und Endpunkte und hat sein eigenes Kontingent.
Schlüssel schützen
- Den Schlüssel nur auf dem Server benutzen, nie im Browser oder in einer App, die du verteilst.
- Nicht ins Repository einchecken. Umgebungsvariable oder Geheimnisspeicher nehmen.
- Für jedes Programm einen eigenen Schlüssel anlegen. Dann widerrufst du im Ernstfall nur einen.
Wenn es nicht klappt
| Status | code | Bedeutung |
|---|---|---|
| 401 | unauthorized | Die Kopfzeile Authorization fehlt, beginnt nicht mit Bearer oder der Schlüssel ist falsch, abgeschnitten oder widerrufen. |
| 403 | forbidden | Modell oder Endpunkt ist für diesen Schlüssel nicht freigegeben. |