ForHosting KIT · Validar e conferir

Como ler um user agent

Esta ferramenta traduz a linha de user agent — aquele texto comprido dos logs e relatórios — em informação legível: navegador e versão, sistema operacional, tipo de dispositivo e se o acesso vem de um robô conhecido, como o crawler de um buscador. Grátis, direto na página, sem cadastro.

● EstávelGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

De onde vem essa linha

Todo navegador, app e robô se apresenta ao servidor com uma frase de identificação — o user agent. Ela aparece nos logs de acesso, nos relatórios de analytics e nos cabeçalhos de requisição, num formato herdado dos anos noventa e cheio de arqueologia (“Mozilla/5.0” aparece até no Chrome). Ninguém decifra isso de cabeça com segurança; a ferramenta faz a leitura e devolve os fatos: qual navegador, qual versão, qual sistema, qual tipo de aparelho.

Para que serve na prática

O uso mais comum é diagnóstico: o cliente diz que “o site não abre” e o suporte descobre pelo log que ele está num Android antigo com um navegador de fábrica. Também serve para separar gente de robô nos relatórios (crawlers declarados incham os números), conferir se o público é majoritariamente móvel — no Brasil, quase sempre é — e reproduzir bugs no dispositivo certo em vez de adivinhar qual seria.

Bot declarado não é bot escondido

A identificação de robôs aqui é a dos educados: buscadores, monitores de disponibilidade e ferramentas que se apresentam como tal no próprio user agent. Robô mal-intencionado costuma mentir — copia a assinatura de um Chrome comum. Ou seja: use esta análise para filtrar os bots conhecidos dos seus relatórios, mas saiba que detectar disfarce exige análise de comportamento do acesso, que é um problema diferente.

Logs em massa via API

Um log de servidor tem milhares dessas linhas, e ninguém vai colar uma por uma. A mesma análise existe via API por US$ 0,002 a linha: envie os user agents do período, receba cada um decomposto em campos e monte a estatística que quiser — quais navegadores atender, proporção de celular, fatia de crawlers. É o caminho rápido para transformar log bruto em decisão de compatibilidade.

Casos de uso

Suporte que descobre o navegador do cliente

“Não consigo anexar o arquivo” — o atendente localiza o acesso no log, cola o user agent e descobre um navegador de 2019. A orientação sai certeira: atualizar, em vez de uma hora de tentativa e erro.

Relatório sem crawler

Antes de apresentar os números do mês, a equipe de marketing separa os acessos de robôs declarados. A audiência real fica visível — e a decisão de mídia, mais honesta.

Matriz de testes realista

O time de QA da TecnoSul Soluções Digitais analisa os user agents de um mês de acessos e monta a lista de navegadores que realmente precisa testar, em vez de seguir uma lista genérica da internet.

Perguntas frequentes

Onde encontro o user agent de um acesso?

Nos logs do servidor web (cada linha de acesso traz um), nos relatórios detalhados de analytics e nas ferramentas de desenvolvedor do navegador. Copie a linha — ou só o trecho do user agent — e cole aqui.

Ele identifica qualquer robô?

Identifica os que se declaram — crawlers de buscador, monitores, bots de redes sociais. Robô disfarçado de navegador comum não é detectável só pelo user agent; isso pede análise de comportamento do acesso, que é outra categoria de verificação.

As linhas que eu colo saem do meu computador?

Não saem: a análise roda no seu navegador. Como user agent costuma vir acompanhado de IP e URL no log, essa garantia importa — cole a linha sem preocupação e remova o resto se preferir.

Quanto custa?

A análise na página é grátis e ilimitada, sem cadastro. Para processar logs em volume, a API cobra US$ 0,002 por linha analisada — dez mil linhas por US$ 20, pagos por uso.

O user agent identifica uma pessoa?

Sozinho, não — ele descreve o programa e o aparelho, não o usuário. Mas combinado com IP e horário ele compõe um registro de acesso, então, pela LGPD, trate logs com o mesmo cuidado de qualquer dado de visitante.

A versão do navegador que aparece é confiável?

Em geral sim, com uma ressalva: navegadores modernos congelam ou simplificam partes da string por privacidade, e apps com navegador embutido (o do WhatsApp ou o do Instagram, por exemplo) têm assinaturas próprias, que a análise aponta quando as reconhece.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/verify/user-agent

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/verify/user-agent \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/verify/user-agent", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/verify/user-agent",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/user-agent", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/user-agent", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "verify.user_agent",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →

Executar grátis