ForHosting KIT · Verifiche e controlli

Analisi user agent

Lo user agent è la stringa che ogni browser invia a un sito per presentarsi. Questo strumento la interpreta e ti dice in chiaro browser e versione, sistema operativo, tipo di dispositivo e se sembra un bot. Trasforma una riga tecnica e illeggibile in informazioni utili, comode per chi analizza i log del server o le statistiche dei visitatori.

● StabileGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Che cosa nasconde quella stringa

Uno user agent è una riga fitta di sigle: nomi di browser, numeri di versione, sistema operativo, motore di rendering, spesso con pezzi ereditati da vecchie compatibilità che la rendono confusa da leggere a occhio. Lo strumento la scompone e ti restituisce i dati che contano: qual è il browser e in che versione, su quale sistema operativo gira, se il dispositivo è un telefono, un tablet o un computer. Quello che a colpo d’occhio è indecifrabile diventa una scheda ordinata.

Bot o persona?

Molti bot si dichiarano nello user agent: crawler dei motori di ricerca, strumenti di monitoraggio, script automatici lasciano una firma riconoscibile. Lo strumento la segnala, così mentre analizzi i log distingui a colpo d’occhio i visitatori reali dal traffico automatico dichiarato. Attenzione però: la stringa si può falsificare, quindi non è una prova. Per una stima più solida di quanto una richiesta sia automatica c’è uno strumento dedicato che pesa anche l’indirizzo IP.

Dove torna utile

A chi guarda i log del server e vuole capire con quali browser e dispositivi arrivano i visitatori, senza affidarsi solo a uno strumento di statistiche esterno. A chi fa assistenza e deve ricostruire l’ambiente di un utente che segnala un problema (“con quale browser stava navigando?”). A chi sviluppa e vuole controllare come si presenta un client. In tutti questi casi leggere lo user agent in chiaro fa risparmiare tempo.

Come si usa

Incolla la stringa nella pagina e premi Esegui: gira nel tuo browser, gratis e senza limiti, e nulla viene inviato a un server. Ottieni la scheda con browser, versione, sistema operativo e dispositivo. Se devi interpretare gli user agent in automatico — per esempio elaborando un file di log riga per riga — c’è la versione via API a $0.002 a richiesta, che restituisce gli stessi campi in modo strutturato.

Casi d'uso

Leggere i log del server

Uno sviluppatore analizza gli accessi al sito di Tecnoedil Verona S.n.c. e vuole sapere con quali dispositivi arrivano i visitatori. Interpretando gli user agent dei log ottiene browser e tipo di dispositivo in chiaro, senza decifrare le sigle a mano.

Assistenza a un utente

Un utente segnala che il sito “si vede male”. Chiedendogli lo user agent e passandolo al KIT, chi fa supporto scopre browser e versione esatti e riproduce il problema nello stesso ambiente.

Separare i bot dichiarati nelle statistiche

Chi tiene le statistiche di un blog vuole escludere i crawler dal conteggio dei visitatori. Riconoscere i bot che si dichiarano nello user agent aiuta a ripulire i numeri prima di trarne conclusioni.

Domande frequenti

Cosa mi dice esattamente?

Browser e versione, sistema operativo, tipo di dispositivo (telefono, tablet, computer) e se lo user agent appartiene a un bot dichiarato. In pratica traduce in chiaro una stringa tecnica altrimenti difficile da leggere.

Il bot che segnala è affidabile al 100%?

No. Riconosce i bot che si dichiarano onestamente nella stringa, ma lo user agent si può falsificare: un bot può fingersi un browser qualsiasi. Per una stima più robusta di quanto una richiesta sia automatica serve lo strumento di rilevamento bot, che considera anche l’indirizzo IP.

La stringa che incollo viene inviata a un server?

No. L’interpretazione gira nel tuo browser: nulla esce dal dispositivo, gratis, senza limiti e senza registrazione. Solo con la versione via API il dato viene elaborato sui nostri server e non conservato.

Posso interpretare gli user agent di un intero file di log?

Nel browser ne analizzi uno alla volta, gratis. Per un file di log conviene l’API, a $0.002 a richiesta, che restituisce i campi in modo strutturato per ogni riga che le passi.

Riconosce i browser e i dispositivi più recenti?

Sì, interpreta i browser e i sistemi operativi diffusi, comprese le versioni mobile. Con un dispositivo appena uscito e ancora poco noto qualche campo può risultare generico, ma browser e tipo di dispositivo vengono comunque identificati.

Devo registrarmi?

No. Nel browser è gratis e senza account. Con l’API paghi a consumo, con acquisto diretto e senza abbonamento.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

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

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

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)

Esempio di richiesta

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

Esempio di risposta

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

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser