Menü

Dokumentation

Client Info API

Ermittle Browser, Betriebssystem, Gerätetyp, IP-Details und Spracheinstellungen des anfragenden Clients, vollständig serverseitig ohne externe Dienste.

Client-Info
https://api.flowdata.one/v1/client-info

OpenAPI-Datei dieses Bereichs

Schnellstart

FlowData-Schlüssel
Diese API gehört zu FlowData und nutzt eigene Schlüssel (fd_...), die du im Dashboard unter API-Schlüssel anlegst. FlowSuite-Schlüssel (pk_..., at_...) funktionieren weiterhin, wir empfehlen aber einen FlowData-Schlüssel.
Keine Parameter erforderlich
Alle Daten werden direkt aus den Request-Headern des anfragenden Clients gelesen. Query- oder Body-Parameter sind nicht nötig.

Analysierte Daten

Die Client Info API liest diese Informationen aus der eingehenden HTTP-Anfrage:

  • IP-Adresse (IPv4/IPv6), numerische Darstellung, Proxy-Hinweis
  • Gerätetyp: iPhone, iPad, Android, Mac, PC, Linux, Tablet oder Smartphone
  • Betriebssystem mit Version
  • Browser: Name, Version, Familie
  • Bot-Erkennung für Suchmaschinen und Crawler
  • Sprach-Präferenzen aus dem Accept-Language-Header

API-Endpunkt

GET
/v1/client-info

Client-Informationen abrufen

Liest die Request-Header des anfragenden Clients aus und antwortet mit den erkannten Informationen. Keine Parameter nötig.

Bearer fd_…

curl -X GET "https://api.flowdata.one/v1/client-info" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_DEIN_SCHLUESSEL')
    ->get('https://api.flowdata.one/v1/client-info');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/client-info', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/client-info',
    headers=headers,
)

data = response.json()
{
    "ipString": "203.0.113.42",
    "ipNumeric": 3405803818,
    "ipType": "IPv4",
    "isBehindProxy": false,
    "device": "Mac",
    "os": "Mac OS X 12.6.0",
    "userAgent": "Chrome 120.0.0",
    "family": "Chrome",
    "versionMajor": "120",
    "versionMinor": "0",
    "versionPatch": "0",
    "isSpider": false,
    "isMobile": false,
    "userAgentDisplay": "Mac OS X 12.6.0 Mac Chrome 120.0.0",
    "userAgentRaw": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    "userLanguages": [
        "de-DE",
        "de",
        "en-US",
        "en"
    ]
}

Antwortfelder

Datenfelder

IP-Daten

  • ipString: IP-Adresse als Text
  • ipNumeric: Numerische IP (IPv4)
  • ipType: IPv4 oder IPv6
  • isBehindProxy: Hinweis auf einen Proxy

Gerät und Betriebssystem

  • device: Gerätename
  • os: Betriebssystem mit Version
  • isMobile: Mobilgerät erkannt

Browser

  • userAgent: Browser mit Version
  • family: Browser-Familie
  • versionMajor, versionMinor, versionPatch: Versionsteile
  • userAgentRaw: Original-User-Agent

Weitere Felder

  • isSpider: Bot oder Crawler erkannt
  • userLanguages: Sprach-Präferenzen als Liste
  • userAgentDisplay: Zusammengefasster Anzeigetext

Anwendungsfälle

Auswertung

  • Geräte- und Browser-Statistiken
  • Mobil gegenüber Desktop vergleichen
  • Verteilung der Betriebssysteme
  • Bot-Anteil filtern

Sicherheit

  • Bot-Zugriffe erkennen
  • Hinweise auf Proxys auswerten

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.