O Client Info analisa o que um navegador ou programa envia em cada requisição: endereço IP, navegador e versão, sistema operacional, tipo de dispositivo e idiomas preferidos. Com isso você pode pré-selecionar o idioma de uma página, separar estatísticas por dispositivo ou filtrar bots. Tudo é lido diretamente da requisição, sem serviço externo.
A requisição
O Client Info não tem parâmetros:
curl "https://api.flowdata.one/v1/client-info" \
-H "Authorization: Bearer fd_SUA_CHAVE"
A resposta
Esta é a resposta para um navegador Chrome no Windows com idioma alemão configurado:
{
"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"]
}
Os campos em detalhe:
- ipString: o endereço IP de quem faz a chamada.
- ipNumeric: o mesmo endereço em forma de número, útil para comparar faixas. Somente IPv4; em IPv6 vem
null. - ipType:
IPv4ouIPv6. - isBehindProxy:
truequando a requisição contém cabeçalhos de proxy comoX-Forwarded-ForouVia. - device: o tipo de dispositivo, por exemplo
PC,Mac,iPhone,iPad,Android Phone,Android TabletouLinux Desktop. Se não for possível detectar algo mais específico, vemDesktopouMobile. - os: sistema operacional com versão, como
Windows 10,Mac OS X 10.15.7,iOS 17.5ouAndroid 14. - userAgent, family: o navegador com versão e a família do navegador, por exemplo
Chrome,Edge,Firefox,SafariouMobile Safari. Navegadores desconhecidos informamUnknown. - versionMajor, versionMinor, versionPatch: a versão do navegador em partes.
- isSpider:
truepara mecanismos de busca, bots e scripts. - isMobile:
truepara smartphones e a maioria dos tablets. - userAgentDisplay: sistema operacional, dispositivo e navegador em uma linha legível.
- userAgentRaw: o user agent sem alterações, ou
Unknownse não houver nenhum. - userLanguages: os idiomas preferidos na ordem em que o navegador envia, sem pesos. Sem idioma informado, a lista fica vazia.
Dados do seu visitante em vez dos do seu servidor
Como sua chave deve ficar no servidor, a requisição ao Client Info normalmente vem do seu servidor. Sem mais nada, a resposta descreve então o seu servidor e o programa que envia a requisição, como curl ou uma biblioteca HTTP.
Para obter navegador, dispositivo e idioma do seu visitante, repasse os cabeçalhos dele:
- Na sua aplicação, leia os cabeçalhos
User-AgenteAccept-Languageda requisição do visitante. - Envie-os sem alterações na sua requisição ao Client Info:
curl "https://api.flowdata.one/v1/client-info" \
-H "Authorization: Bearer fd_SUA_CHAVE" \
-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"
A resposta traz então, entre outros, "device": "iPhone", "os": "iOS 17.5", "userAgent": "Mobile Safari 17.5", "isMobile": true e "userLanguages": ["de-DE", "de"].
O endereço IP em ipString continua sendo o do seu servidor. Para saber a localização do visitante, consulte o IP Geolocation com o endereço IP dele; veja Por que o IP Geolocation mostra o local do meu servidor e não o do meu visitante?.
Por que isSpider é true no meu teste?
O Client Info reconhece não só mecanismos de busca, mas também ferramentas e scripts típicos. Se o user agent contiver algo como curl, wget, python-requests, Postman, bot, crawler ou spider, isSpider será true. Um teste com curl ou Postman é, portanto, tratado de propósito como bot. Para testar, envie um user agent de navegador real, como no exemplo acima.
Por que o Windows 11 aparece como Windows 10?
Os navegadores informam o Windows 10 e o Windows 11 com o mesmo identificador no user agent, então não é possível distinguir os dois por ele. O Client Info mostra Windows 10 para ambos.
Por que meu tablet Android aparece como Android Phone?
Muitos tablets Android enviam o mesmo user agent de um smartphone. O Client Info só informa Android Tablet se a palavra "tablet" estiver no user agent. Se você precisa de uma distinção exata, combine a informação com a largura da tela, que você mesmo pode ler no navegador.
Bom saber
- O Client Info é gratuito, mas você precisa de uma chave válida do FlowData; veja Criar uma chave de API do FlowData.
- Cada requisição aparece no Registro em Áreas › Client Info. O ícone de olho mostra o endereço IP e o user agent da requisição.
- A referência completa está na documentação da API.