FlowData

Como detectar navegador, dispositivo e idioma com o Client Info?

Publicado em 10. novembro 2026

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: IPv4 ou IPv6.
  • isBehindProxy: true quando a requisição contém cabeçalhos de proxy como X-Forwarded-For ou Via.
  • device: o tipo de dispositivo, por exemplo PC, Mac, iPhone, iPad, Android Phone, Android Tablet ou Linux Desktop. Se não for possível detectar algo mais específico, vem Desktop ou Mobile.
  • os: sistema operacional com versão, como Windows 10, Mac OS X 10.15.7, iOS 17.5 ou Android 14.
  • userAgent, family: o navegador com versão e a família do navegador, por exemplo Chrome, Edge, Firefox, Safari ou Mobile Safari. Navegadores desconhecidos informam Unknown.
  • versionMajor, versionMinor, versionPatch: a versão do navegador em partes.
  • isSpider: true para mecanismos de busca, bots e scripts.
  • isMobile: true para 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 Unknown se 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:

  1. Na sua aplicação, leia os cabeçalhos User-Agent e Accept-Language da requisição do visitante.
  2. 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.

Este artigo foi útil?

Voltar para Geolocalização de IP e Client Info