Menü

Dokumentation

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
Sende den Schlüssel ausschließlich im Header, nie in der Adresse. Adressen landen in Server- und Proxy-Protokollen.

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

HTTPBedeutung
401Fehlender oder ungültiger Schlüssel
402Das Konto kann die Anfrage nicht decken (insufficient_quota) oder das Ausgabenlimit ist erreicht (spend_limit_exceeded)
403Der Schlüssel darf diesen Bereich nicht nutzen, oder das Konto ist gesperrt (billing_suspended)
429Zu 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.

Ein Schlüssel reicht für den Anfang.

Leg einen Schlüssel an und ruf die API auf. Client-Info kostet nichts, alles andere rechnest du je erfolgreicher Anfrage ab.

API-Schlüssel anlegen Dokumentation

FlowData richtet sich ausschließlich an Unternehmen und Selbstständige.