Client Info wertet die Angaben aus, die ein Browser oder Programm bei jeder Anfrage mitschickt: IP-Adresse, Browser mit Version, Betriebssystem, Gerätetyp und bevorzugte Sprachen. Damit kannst du zum Beispiel die Sprache einer Seite vorauswählen, Statistiken nach Gerät aufteilen oder Anfragen von Bots aussortieren. Alles wird direkt aus der Anfrage gelesen, ohne externen Dienst.
Die Anfrage
Client Info hat keine Parameter:
curl "https://api.flowdata.one/v1/client-info" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
Die Antwort
So sieht die Antwort für einen Chrome-Browser unter Windows mit deutscher Spracheinstellung aus:
{
"ipString": "203.0.113.24",
"ipNumeric": 3405803800,
"ipType": "IPv4",
"isBehindProxy": false,
"device": "PC",
"os": "Windows 10",
"userAgent": "Chrome 130.0.0.0",
"family": "Chrome",
"versionMajor": "130",
"versionMinor": "0",
"versionPatch": "0",
"isSpider": false,
"isMobile": false,
"userAgentDisplay": "Windows 10 PC Chrome 130.0.0.0",
"userAgentRaw": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
"userLanguages": ["de-DE", "de", "en"]
}
Die Felder im Einzelnen:
- ipString: die IP-Adresse des Aufrufers.
- ipNumeric: dieselbe Adresse als Zahl, praktisch für Bereichsvergleiche. Nur bei IPv4, bei IPv6 steht hier
null. - ipType:
IPv4oderIPv6. - isBehindProxy:
true, sobald die Anfrage Proxy-Header wieX-Forwarded-ForoderViaenthält. - device: Gerätetyp, zum Beispiel
PC,Mac,iPhone,iPad,Android Phone,Android TabletoderLinux Desktop. Lässt sich nichts Genaueres erkennen, steht hierDesktopoderMobile. - os: Betriebssystem mit Version, etwa
Windows 10,Mac OS X 10.15.7,iOS 17.5oderAndroid 14. - userAgent, family: Browser mit Version und die Browserfamilie, zum Beispiel
Chrome,Edge,Firefox,SafarioderMobile Safari. Unbekannte Browser meldenUnknown. - versionMajor, versionMinor, versionPatch: die Browserversion in Einzelteilen.
- isSpider:
truebei Suchmaschinen, Bots und Skripten. - isMobile:
truebei Smartphones und den meisten Tablets. - userAgentDisplay: Betriebssystem, Gerät und Browser in einer lesbaren Zeile.
- userAgentRaw: der unveränderte User-Agent. Fehlt er, steht hier
Unknown. - userLanguages: die bevorzugten Sprachen in der Reihenfolge, die der Browser sendet, ohne Gewichtung. Ohne Sprachangabe ist die Liste leer.
Daten deines Besuchers statt deines Servers
Weil dein Schlüssel auf den Server gehört, kommt die Anfrage an Client Info normalerweise von deinem Server. Ohne weitere Angaben beschreibt die Antwort dann deinen Server und das Programm, das die Anfrage schickt, etwa curl oder eine HTTP-Bibliothek.
Für Browser, Gerät und Sprache deines Besuchers reichst du dessen Header weiter:
- Lies in deiner Anwendung die Header
User-AgentundAccept-Languageder Besucheranfrage aus. - Schick sie in deiner Anfrage an Client Info unverändert mit:
curl "https://api.flowdata.one/v1/client-info" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
-H "User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1" \
-H "Accept-Language: de-DE,de;q=0.9"
In der Antwort steht dann unter anderem "device": "iPhone", "os": "iOS 17.5", "userAgent": "Mobile Safari 17.5", "isMobile": true und "userLanguages": ["de-DE", "de"].
Die IP-Adresse in ipString bleibt dabei die deines Servers. Für den Standort deines Besuchers fragst du IP Geolocation mit seiner IP-Adresse ab, siehe Warum zeigt IP Geolocation den Standort meines Servers statt den meines Besuchers?.
Warum ist isSpider bei meinem Test true?
Client Info erkennt nicht nur Suchmaschinen, sondern auch typische Werkzeuge und Skripte. Enthält der User-Agent zum Beispiel curl, wget, python-requests, Postman, bot, crawler oder spider, steht isSpider auf true. Ein Test mit curl oder Postman wird also absichtlich als Bot gewertet. Schick zum Testen einen echten Browser-User-Agent mit, wie im Beispiel oben.
Warum steht bei Windows 11 Windows 10?
Browser melden Windows 10 und Windows 11 mit derselben Kennung im User-Agent. Anhand des User-Agents lassen sich die beiden deshalb nicht unterscheiden, und Client Info zeigt für beide Windows 10.
Warum wird mein Android-Tablet als Android Phone erkannt?
Viele Android-Tablets schicken denselben User-Agent wie ein Smartphone. Nur wenn das Wort „Tablet“ im User-Agent steht, meldet Client Info Android Tablet. Brauchst du die Unterscheidung genau, kombiniere die Angabe mit der Bildschirmbreite, die du im Browser selbst auslesen kannst.
Gut zu wissen
- Client Info ist kostenlos, du brauchst aber einen gültigen FlowData-Schlüssel, siehe FlowData-API-Schlüssel anlegen.
- Jede Anfrage steht unter Bereiche › Client Info im Protokoll. Mit dem Augensymbol siehst du IP-Adresse und User-Agent der Anfrage.
- Die vollständige Referenz steht in der API-Dokumentation.