Menu

Documentação

API de Informações do Cliente

Descubra navegador, sistema operacional, tipo de dispositivo, detalhes de IP e idiomas do cliente que faz a requisição, totalmente no servidor e sem serviços externos.

Informações do cliente
https://api.flowdata.one/v1/client-info

Arquivo OpenAPI desta área

Início rápido

Chave FlowData
Esta API faz parte da FlowData e usa chaves próprias (fd_...), que você cria no dashboard em Chaves de API. Chaves FlowSuite (pk_..., at_...) continuam funcionando, mas recomendamos uma chave FlowData.
Sem parâmetros
Todos os dados são lidos diretamente dos cabeçalhos da requisição do cliente. Nenhum parâmetro de consulta ou corpo é necessário.

Dados analisados

A API de Informações do Cliente lê estes dados da requisição HTTP recebida:

  • Endereço IP (IPv4/IPv6), representação numérica, indício de proxy
  • Tipo de dispositivo: iPhone, iPad, Android, Mac, PC, Linux, tablet ou smartphone
  • Sistema operacional com versão
  • Navegador: nome, versão, família
  • Detecção de bots de buscadores e crawlers
  • Preferências de idioma do cabeçalho Accept-Language

Endpoint da API

GET
/v1/client-info

Obter informações do cliente

Lê os cabeçalhos da requisição do cliente e responde com as informações detectadas. Nenhum parâmetro necessário.

Bearer fd_…

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

$response = Http::withToken('fd_SUA_CHAVE')
    ->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_SUA_CHAVE',
    'Accept': 'application/json',
  },
});

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

headers = {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    '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"
    ]
}

Campos da resposta

Campos

Dados de IP

  • ipString: endereço IP como texto
  • ipNumeric: IP numérico (IPv4)
  • ipType: IPv4 ou IPv6
  • isBehindProxy: indício de proxy

Dispositivo e sistema operacional

  • device: nome do dispositivo
  • os: sistema operacional com versão
  • isMobile: dispositivo móvel detectado

Navegador

  • userAgent: navegador com versão
  • family: família do navegador
  • versionMajor, versionMinor, versionPatch: partes da versão
  • userAgentRaw: user agent original

Outros campos

  • isSpider: bot ou crawler detectado
  • userLanguages: preferências de idioma como lista
  • userAgentDisplay: texto resumido de exibição

Casos de uso

Análise

  • Estatísticas de dispositivos e navegadores
  • Comparar móvel e desktop
  • Distribuição de sistemas operacionais
  • Filtrar tráfego de bots

Segurança

  • Detectar acesso de bots
  • Avaliar indícios de proxy

Uma chave basta para começar.

Crie uma chave e chame a API. As informações do cliente são gratuitas; o restante é cobrado por solicitação bem-sucedida.

Criar chave de API Documentação

O FlowData é destinado exclusivamente a empresas e profissionais autônomos.