ForHosting KIT · Lettura e monitoraggio di siti web

Analizzi un User-Agent: browser, sistema e dispositivo

L’intestazione User-Agent è compatta ma difficile da leggere, perché i produttori uniscono in una sola riga token di prodotto, indicatori di compatibilità, informazioni sul sistema operativo e segnali del dispositivo.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Questo analizzatore restituisce un risultato prevedibile con nome e versione del browser, sistema operativo e versione, oltre a una categoria pratica del dispositivo. Usa regole trasparenti e deterministiche: lo stesso input genera sempre lo stesso output, senza richieste di rete, casualità, fingerprinting o arricchimenti nascosti.

Fornisca l’intestazione completa quando possibile

Incolli il valore dell’intestazione HTTP User-Agent nel campo user_agent, includendo tutti i token di prodotto e la sezione della piattaforma tra parentesi. Le stringhe complete offrono indizi sufficienti per distinguere browser che condividono la stessa famiglia di rendering. Per esempio, le stringhe moderne di Edge, Opera, Samsung Internet e Chrome possono contenere tutte il token Chrome; l’analizzatore controlla quindi gli identificatori più specifici prima di accettare la corrispondenza generica di Chrome. L’ordine è importante anche per Firefox e Chrome su iOS, dove i requisiti della piattaforma Apple producono stringhe diverse da quelle desktop. Gli spazi iniziali e finali vengono ignorati, ma un valore vuoto o composto solo da spazi viene rifiutato come input non valido, perché non offre nulla da classificare. L’analizzatore non contatta il dispositivo, non consulta l’indirizzo IP, non esamina i Client Hints e non combina la stringa con altri identificatori. Se Le servono le versioni, invii l’intestazione originale invece di un’etichetta abbreviata. Una stringa ridotta o sconosciuta può essere accettata, ma i campi privi di indizi riconoscibili restituiscono Sconosciuto e una versione nulla, senza supposizioni.

Comprenda le regole per browser e sistema operativo

Il rilevamento segue una tabella di precedenza fissa basata sui comuni token User-Agent. I token specifici Edg, OPR, SamsungBrowser, CriOS e FxiOS vengono valutati prima dei modelli generici di Chrome, Firefox e Safari. In questo modo un browser basato su Chromium non viene etichettato erroneamente come Chrome solo perché include quel nome per compatibilità. Safari usa il token Version, poiché il token Safari separato descrive la famiglia del prodotto e non la versione pubblica del browser. L’analisi del sistema verifica analogamente Windows Phone prima di Windows desktop, Android prima di Linux generico e iOS prima dei frammenti di compatibilità macOS. I trattini bassi nelle versioni Apple diventano punti. I valori Windows NT sono associati alle versioni note quando esiste una corrispondenza convenzionale affidabile; Windows NT 10.0 viene indicato intenzionalmente come “10 o 11”, perché l’intestazione tradizionale non consente di distinguerli con certezza. Si tratta di regole su modelli noti, non di affermazioni probabilistiche. Nuovi prodotti, stringhe ridotte per la privacy, web view integrate e varianti dei produttori possono quindi restituire Sconosciuto o una famiglia ampia finché non esiste un segnale identificabile. Questo comportamento prudente è più sicuro di una precisione inventata.

Usi il tipo di dispositivo come categoria pratica, non come identità

Il risultato device_type è una categoria operativa generale: desktop, mobile, tablet, bot o sconosciuto. Gli indicatori dei tablet vengono controllati prima di quelli mobili generici, perché molti tablet Android includono Android ma omettono intenzionalmente Mobile. Telefoni riconosciuti, iPhone, iPod, Windows Phone e altri token mobili restituiscono mobile. I termini comuni dei crawler restituiscono bot, utile per riepilogare i log ma non sostitutivo di controlli antiabuso stratificati o dell’autenticazione dei crawler verificati. Un sistema operativo o browser desktop riconoscibile viene classificato come desktop; una stringa senza indizi noti sul browser o sul sistema restituisce sconosciuto. Queste categorie descrivono ciò che il mittente dichiara, non un dispositivo fisico verificato. I valori User-Agent possono essere modificati, i client automatici possono imitare i browser e le moderne funzioni di privacy riducono intenzionalmente i dettagli. Usi il risultato per report, arricchimento dei log, indicazioni di compatibilità o per scegliere un’esperienza iniziale sensata. Non lo usi come confine di sicurezza, impronta univoca o prova di possesso. Quando la correttezza riguarda accessi, pagamenti o frodi, combini autorizzazione lato server e segnali di rischio dedicati.

Arricchire i log delle richieste

Converta le intestazioni grezze in colonne coerenti per browser, sistema e dispositivo, facilitando i report operativi.

Riepilogare il traffico

Raggruppi le visite in categorie generali di browser e dispositivo senza inviare l’intestazione a un servizio esterno.

Scegliere impostazioni compatibili

Selezioni un’interfaccia iniziale o un messaggio di assistenza sensato, lasciando alla verifica delle funzioni la decisione finale.

Quanto costa un’analisi?

Ogni richiesta API costa $0.002. La versione deterministica per browser può anche essere eseguita localmente nella pagina.

Perché Windows risulta 10 o 11?

Le stringhe User-Agent tradizionali mostrano in genere Windows NT 10.0 per entrambi, quindi l’intestazione non li distingue con certezza.

User-Agent è affidabile per decisioni di sicurezza?

No. I client possono modificare o imitare l’intestazione. Consideri il risultato un metadato descrittivo, non un’identità verificata.

Cosa accade se il browser non viene riconosciuto?

Il browser restituisce Sconosciuto e una versione nulla. Gli eventuali indizi riconoscibili sul sistema o dispositivo vengono comunque mostrati.

L’analisi consulta un servizio esterno?

No. Applica regole locali e deterministiche, senza richieste di rete, fingerprinting o arricchimento tramite IP.

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.

POSThttps://api.kit.forhosting.com/web/user-agent-parse

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

curl -X POST https://api.kit.forhosting.com/web/user-agent-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"}'
{
  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.user_agent_parse",
  "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.

per richiesta$0.002

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

timeout_sec30
max_crawl_pages25
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →