user-agent-string.info API
API user-agent-string.info je určen k automatickému poskytování informací o useragentech. Použití je jednoduché, pošlete řetězec UA na náš server a obdržíte automatickou odpověď podle vybrané metodiky.
API jsme dočasně zpřístupnili bez omezení. Přes plánované zpoplatnění této služby máme v úmyslu zachovat verzi zdarma s omezením počtu dotazů/čas.
Naše API umožňuje přístup pomocí metod XML-RPC nebo TXT-RPC
XML-RPC
Popis použití user-agent-string.info XML-RPC:
Pošlete POST požadavek na http://user-agent-string.info/rpc/rpcxml.php. Zde je povolena pouze jedna metoda a to ua.search, která vyžaduje dva parametry.
| Parametr | Popis |
|---|---|
| uastrig | string UA konvertovaný pomocí base64 |
| acceskey | string "free" nebo Vám přidělený klíč |
Příklad požadavku pro UA "Googlebot-Image/1.0" odeslaný metodou POST
<?xml version="1.0"?>
<methodCall>
<methodName>ua.search</methodName>
<params>
<param>
<value><string>R29vZ2xlYm90LUltYWdlLzEuMA==</string></value>
</param>
<param>
<value><string>free</string></value>
</param>
</params>
</methodCall>
Odpověď:
Formát odpovědi obsahuje výběr z následujích hodnot (vše kódováno v UTF-8):
| Proměnná | Hodnota | Popis |
|---|---|---|
| flag | "0" "1" "2" "3" "4" "5" | Návratový kód komunikace: OK neznámý OS neznámy UA neznámý OS i UA chybný, nebo nesprávný klíč systémová chyba |
| errortext | hodnota typu string | Popis chyby, platí jen pro flag 4 a 5 |
| typ | "robot" "browser" "offline browser" "ua anonymizer" | Zobrazuje typ nalezeného UA |
| ua_name | hodnota typu string "unknown" | Název nalezeného UA nebo "unknown" v případě, že není znám |
| ua_family | hodnota typu string "unknown" | Název tzv. rodiny nalezeného UA nebo "unknown" v případě, že není známa |
| ua_url | hodnota typu string "unknown" | URL nalezeného UA nebo "unknown" v případě, že není známa |
| ua_company | hodnota typu string "unknown" | Výrobce nalezeného UA nebo "unknown" v případě, že není znám |
| ua_company_url | hodnota typu string "unknown" | URL výrobce nalezeného UA nebo "unknown" v případě, že není známa |
| ua_icon | hodnota typu string "unknown" | URL ikony nalezeného UA nebo "unknown" v případě, že není známa |
| os_name | hodnota typu string "unknown" | Název OS nalezeného UA nebo "unknown" v případě, že není znám |
| os_family | hodnota typu string "unknown" | Název rodiny OS nalezeného UA nebo "unknown" v případě, že není známa |
| os_url | hodnota typu string "unknown" | URL OS nalezeného UA nebo "unknown" v případě, že není známa |
| os_company | hodnota typu string "unknown" | Název výrobce OS nalezeného UA nebo "unknown" v případě, že není znám |
| os_company_url | hodnota typu string "unknown" | URL výrobce OS nalezeného UA nebo "unknown" v případě, že není známa |
| os_icon | hodnota typu string "unknown" | URL ikony nalezeného UA nebo "unknown" v případě, že není známa |
Příklad chybové odpovědi:
<?xml version="1.0"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>flag</name>
<value><int>5</int></value>
</member>
<member>
<name>errortext</name>
<value><string>system error</string></value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
Příklad korektní odpovědi:
<?xml version="1.0"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>flag</name>
<value><int>1</int></value>
</member>
<member>
<name>typ</name>
<value><string>robot</string></value>
</member>
<member>
<name>ua_family</name>
<value><string>Googlebot-Image</string></value>
</member>
<member>
<name>ua_name</name>
<value><string>Googlebot-Image/1.0</string></value>
</member>
<member>
<name>ua_url</name>
<value><string>http://www.google.com/bot.html</string></value>
</member>
<member>
<name>ua_company</name>
<value><string>Google Inc.</string></value>
</member>
<member>
<name>ua_company_url</name>
<value><string>http://www.google.com/</string></value>
</member>
<member>
<name>ua_icon</name>
<value><string>http://ua.loc/img/ua/bot.png</string></value>
</member>
<member>
<name>os_family</name>
<value><string>unknown</string></value>
</member>
<member>
<name>os_name</name>
<value><string>unknown</string></value>
</member>
<member>
<name>os_url</name>
<value>
<string>unknown</string></value>
</member>
<member>
<name>os_company</name>
<value><string>unknown</string></value>
</member>
<member>
<name>os_company_url</name>
<value><string>unknown</string></value>
</member>
<member><name>os_icon</name>
<value><string>http://ua.loc/img/os/unknown.png</string></value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
Pro zájemce připojujeme funkční příklad v PHP,
včetně jeho zdroje a specifikace XML-RPC 
.
TXT-RPC
Popis použití user-agent-string.info TXT-RPC:
Pošlete GET požadavek na http://user-agent-string.info/rpc/rpctxt.php s dvěma parametry.
| Parametr | Popis |
|---|---|
| uastrig | string UA konvertovaný pomocí base64 |
| acceskey | string "free" nebo Vám přidělený klíč |
Příklad požadavku pro UA "Googlebot-Image/1.0" odeslaný metodou GET:
http://ua.loc/rpc/rpctxt.php?key=free&ua=R29vZ2xlYm90LUltYWdlLzEuMA==
Odpověď:
Formát odpovědi obsahuje výběr z následujích hodnot oddělených znakem "|" (vše kódováno v UTF-8):
| Proměnná | Hodnota | Popis |
|---|---|---|
| flag | "0" "1" "2" "3" "4" "5" | Návratový kód komunikace: OK neznámý OS neznámy UA neznámý OS i UA chybný, nebo nesprávný klíč systémová chyba |
| errortext | hodnota typu string | Popis chyby, platí jen pro flag 4 a 5 |
| typ | "robot" "browser" "offline browser" "ua anonymizer" | Zobrazuje typ nalezeného UA |
| ua_name | hodnota typu string "unknown" | Název nalezeného UA nebo "unknown" v případě, že není znám |
| ua_family | hodnota typu string "unknown" | Název tzv. rodiny nalezeného UA nebo "unknown" v případě, že není známa |
| ua_url | hodnota typu string "unknown" | URL nalezeného UA nebo "unknown" v případě, že není známa |
| ua_company | hodnota typu string "unknown" | Výrobce nalezeného UA nebo "unknown" v případě, že není znám |
| ua_company_url | hodnota typu string "unknown" | URL výrobce nalezeného UA nebo "unknown" v případě, že není známa |
| ua_icon | hodnota typu string "unknown" | URL ikony nalezeného UA nebo "unknown" v případě, že není známa |
| os_name | hodnota typu string "unknown" | Název OS nalezeného UA nebo "unknown" v případě, že není znám |
| os_family | hodnota typu string "unknown" | Název rodiny OS nalezeného UA nebo "unknown" v případě, že není známa |
| os_url | hodnota typu string "unknown" | URL OS nalezeného UA nebo "unknown" v případě, že není známa |
| os_company | hodnota typu string "unknown" | Název výrobce OS nalezeného UA nebo "unknown" v případě, že není znám |
| os_company_url | hodnota typu string "unknown" | URL výrobce OS nalezeného UA nebo "unknown" v případě, že není známa |
| os_icon | hodnota typu string "unknown" | URL ikony nalezeného UA nebo "unknown" v případě, že není známa |
Příklad chybové odpovědi:
5|system error
Příklad korektní odpovědi:
1|robot|Googlebot-Image|Googlebot-Image/1.0|http://www.google.com/bot.html| ..... atd.
Pro zájemce připojujeme i zde funkční příklad v PHP a jeho zdroj.