Support > Documentation

API v. 2 - Reference - method "parse"


 
Send POST request to "http://api.udger.com/parse" with following parameters.

ParameterDescriptionMandatory
accesskeyYou access keyYes
uauseragent stringYes

Request example:

POST
accesskey=XXXXXX&Googlebot-Image%2F1.0
to
http://api.udger.com/parse

Answer:

Answer format includes selection of following values (encoded in UTF-8):

VariableValueDescription
flag
"0"
"1"
"2"
"3"
"4"
"6"
"99"
Return code of communication:
OK
unknown OS
unknown UA
unknown OS and UA
incorrect acceskey
exceeded the maximum number of queries
BAD REQUEST
errortextstring type valueError descriptoon, for flag "4", "6" and "99" only
info->type"robot"
"browser"
"mobile browser"
"email client"
"wap browser"
"offline browser"
"ua anonymizer"
"library"
"other"
User agent type
info->ua_name"string"User agent name or "unknown"
info->ua_ver"string"User agent version
info->ua_family"string"User agent family name or "unknown"
info->ua_url"string"User agent URL
info->ua_company"string"User agent producer
info->ua_company_url"string"User agent producer URL
info->ua_icon"string"URL user agent ICO
info->ua_engine"string"User agent engine
info->ua_udger_url"string"URL to udger UA list
info->os_name"string"User agent OS name or "unknown"
info->os_family"string"User agent OS family or "unknown"
info->os_url"string"User agent OS URL
info->os_company"string"User agent producer
info->os_company_url"string"User agent OS producer URL
info->os_icon"string"URL user agent OS ICO
info->os_udger_url"string"URL to udger UA list
info->device_name"Personal computer"
"Tablet"
"Smartphone"
"Game console"
"Smart TV"
"PDA"
"Other"
Device name or "unknown"
info->device_icon"string"URL device ICO
info->device_udger_url"string"URL to udger UA list
fragments->[FRAGRMENT]"array"
"fragment"->"fragment note"
User agent fragments
uptodate->controlled"true"
"false"
Are checked only major browsers like Chrome, Firefox, Opera ..
uptodate->is"true"
"false"
Ok, browser is up to date.
It would be appropriate uptade
uptodate->ver"int"Current major version
uptodate->url"string"URL for update

Error answer (example):

{
	"flag": 4,
	"errortext": "incorrect acceskey"
}

Correct answer (example):

{
	"flag": 0,
	"info": {
		"type": "Browser",
		"ua_name": "Chrome 39.0.2171.95",
		"ua_ver": "39.0.2171.95",
		"ua_family": "Chrome",
		"ua_url": "http:\/\/www.google.com\/chrome",
		"ua_company": "Google Inc.",
		"ua_company_url": "http:\/\/www.google.com\/",
		"ua_icon": "http:\/\/udger.com\/pub\/img\/ua\/chrome.png",
		"ua_engine": "WebKit\/Blink",
		"ua_udger_url": "http:\/\/udger.com\/resources\/ua-list\/browser-detail?browser=Chrome",
		"os_name": "Windows 7",
		"os_family": "Windows",
		"os_url": "http:\/\/en.wikipedia.org\/wiki\/Windows_7",
		"os_company": "Microsoft Corporation.",
		"os_company_url": "http:\/\/www.microsoft.com\/",
		"os_icon": "http:\/\/udger.com\/pub\/img\/os\/windows-7.png",
		"os_udger_url": "http:\/\/udger.com\/resources\/ua-list\/os-detail?os=Windows",
		"device_name": "Personal computer",
		"device_icon": "http:\/\/udger.com\/pub\/img\/device\/desktop.png",
		"device_udger_url": "http:\/\/udger.com\/resources\/ua-list\/device-detail?device=Personal computer"
	},
	"fragments": {
		"Mozilla\/5.0": "They claim that it is based on Mozilla user agent (only true for Gecko browsers). It is now used only for historical reasons.",
		"Windows NT 6.1": "OS signature",
		"WOW64": "Windows running on a 64-bit processor signature",
		"AppleWebKit\/537.36": " Open source application framework<\/a> ver. 537.36",
		"(KHTML, like Gecko)": "HTML layout engine developed by the KDE project<\/a>",
		"Chrome\/39.0.2171.95": "browser signature",
		"Safari\/537.36": "browser signature"
	},
	"uptodate": {
		"controlled": true,
		"is": true,
		"ver": "39",
		"url": "http:\/\/www.google.com\/chrome"
	}
}

Among our clients
View more...
 salesforce.com, inc.  
 MailChimp  
 Dailymotion SA  
 Akamai Technologies, Inc.  
 Oracle  
 PayPal Holdings, Inc.