Die FlowData-APIs haben eine eigene Adresse: https://api.flowdata.one/v1. Die alten Pfade unter https://creativeskyline.de/api/... funktionieren ohne Enddatum weiter, du musst also nichts unter Zeitdruck ändern. Dokumentation und Hilfe zeigen aber nur noch die neue Adresse. Beim Umstellen tauschst du die Adresse aus, Parameter und Antworten bleiben gleich.
Alte und neue Pfade
Bisher (https://creativeskyline.de) |
Neu (https://api.flowdata.one) |
|---|---|
GET /api/geolocation |
GET /v1/geolocation |
GET /api/geolocation/{query} |
GET /v1/geolocation/{query} |
POST /api/geolocation/batch |
POST /v1/geolocation/batch |
GET /api/client-info |
GET /v1/client-info |
GET /api/maps/search |
GET /v1/maps/search |
GET /api/maps/geocode |
GET /v1/maps/geocode |
GET /api/maps/directions |
GET /v1/maps/directions |
GET /api/youtube/stats/{identifier} |
GET /v1/youtube/stats/{identifier} |
GET /api/emailverification/{email} |
GET /v1/email-verification/{email} |
/api/media/v1/... |
/v1/media/... |
Achte auf die beiden Abweichungen: Beim Email Verifier heißt der Pfad jetzt email-verification mit Bindestrich, und bei der Medienverarbeitung steht v1 vorne, also zum Beispiel POST /v1/media/jobs statt POST /api/media/v1/jobs.
So stellst du um
- Ersetze in deiner Integration die Basisadresse nach der Tabelle.
- Prüfe, dass dein Schlüssel im Header
Authorization: Bearer ...steht. Ein Schlüssel in der Adresse wird nicht ausgewertet. - Teste die neue Adresse mit einer kostenlosen Anfrage:
curl "https://api.flowdata.one/v1/client-info" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
- Prüfe im Protokoll des Bereichs, ob die Anfragen wie erwartet ankommen. Wie das geht, steht in Statistik und Protokoll.
Deine bestehenden Schlüssel gelten auf beiden Adressen. Das Dashboard hat ebenfalls eine neue Adresse: flowdata.one/dashboard. Alte Links auf creativeskyline.de/flowdata/... leiten automatisch dorthin weiter.
Schlüssel in der Adresse beim Email Verifier
Früher stand in der Dokumentation des Email Verifiers eine Adresse, bei der der Schlüssel mit im Pfad stand: /api/emailverification/{email}/{key}. Diese Form ist veraltet. Der Schlüssel gehört ausschließlich in den Header Authorization. Auf der neuen Adresse gibt es die Form mit Schlüssel im Pfad nicht mehr, ebenso wenig ein weiteres Pfadsegment dahinter.
Die alte Form wird weiterhin angenommen, damit bestehende Integrationen nicht plötzlich ausfallen. Der Teil mit dem Schlüssel wird aber nicht ausgewertet, im Protokoll unkenntlich gemacht und die Antwort trägt den Header Deprecation. Angemeldet wird deine Anfrage nur über den Header. Schickst du die alte Adresse ohne Header, bekommst du HTTP 401.
Adressen landen an vielen Stellen, die du nicht kontrollierst: in Server- und Proxy-Logs, im Browserverlauf, in Monitoring-Werkzeugen und in Fehlerberichten. Wer den Schlüssel dort findet, kann in deinem Namen FlowData aufrufen und dein Guthaben verbrauchen. Stand er jemals in einer Adresse, solltest du ihn deshalb austauschen:
- Stelle die Adresse in deiner Integration um und setze den Header:
curl "https://api.flowdata.one/v1/email-verification/name%40example.com" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
- Prüfe im Protokoll des Bereichs Email Verifier, ob die Anfrage mit Status 200 ankommt.
- Öffne API-Schlüssel, klicke beim betroffenen Schlüssel auf Neu erzeugen und bestätige den Dialog Schlüssel neu erzeugen?.
- Kopiere den neuen Wert. Er wird nur dieses eine Mal angezeigt.
- Trag den neuen Wert in deiner Integration ein.
Der bisherige Wert funktioniert nach dem Neu-Erzeugen noch eine Übergangszeit lang, die Dauer steht im Dialog. So stellst du in Ruhe um, ohne dass deine Integration ausfällt. Der Schlüssel behält seinen Namen, sein Limit und seine Statistik, nur der Wert ändert sich. Neu erzeugen steht nur der Person zur Verfügung, die den Schlüssel angelegt hat. Hat jemand anderes ihn angelegt, widerrufe ihn und leg einen neuen an.
Gut zu wissen
- Mehr zu Schlüsseln, Gültigkeit und Limits steht in FlowData-API-Schlüssel anlegen.
- Die Antwort des Email Verifiers ist bei allen Formen gleich. Was sie bedeutet, erklärt E-Mail-Adresse prüfen.
- Nutzt deine Integration noch einen FlowSuite-Schlüssel, kannst du ihn gleich mit ersetzen, siehe FlowSuite-Schlüssel umstellen.
- Die neue Adresse antwortet immer mit JSON. Einen
Accept-Header musst du nicht setzen.