Authentifizierung
Jede Anfrage an die FlowData API trägt einen Schlüssel im Header Authorization.
Bearer-Schlüssel
Lege im Dashboard unter API-Schlüssel einen Schlüssel an. Er beginnt mit fd_ und wird nur einmal angezeigt. Sende ihn in jeder Anfrage:
Authorization: Bearer fd_DEIN_SCHLUESSEL
Was ein Schlüssel erreicht
Ein FlowData-Schlüssel erreicht alle FlowData-Bereiche des Teams, für das er ausgestellt wurde, und nur diese. Du kannst ihm ein Ablaufdatum und ein monatliches Ausgabenlimit geben.
Ältere Schlüssel
FlowSuite-Schlüssel (pk_..., at_...) funktionieren in den fünf Datenbereichen ohne Enddatum weiter und antworten dort mit dem Header Deprecation. Die Medien-API nimmt sie nicht an und antwortet mit HTTP 403, dafür brauchst du einen FlowData-Schlüssel. Auch für die Datenbereiche empfehlen wir die Umstellung.
Fehlerantworten
| HTTP | Bedeutung |
|---|---|
| 401 | Fehlender oder ungültiger Schlüssel |
| 402 | Das Konto kann die Anfrage nicht decken (insufficient_quota) oder das Ausgabenlimit ist erreicht (spend_limit_exceeded) |
| 403 | Der Schlüssel darf diesen Bereich nicht nutzen, oder das Konto ist gesperrt (billing_suspended) |
| 429 | Zu viele Anfragen. Media-Aufträge melden hier auch fehlende Deckung (insufficient_quota, spend_limit_exceeded) |
Ratenlimits
Medien-Endpunkte erlauben 600 Anfragen und 60 neue Aufträge pro Minute je Schlüssel. Überschreitungen antworten mit 429 und Retry-After.