Detector v3
API Documentation

2021-05-04, 08:23
Martin Kæstel Nielsen
- think.dk

v3 is deprecated - support ends in 2018. v4 is newest version - Upgrade now.

The Detector v3 API provides tools for identification, submission, building and debugging.

The recommended identification request method is made using a server-side request and storing the segment in the users session, as this provides the best user experience and fewest possible requests to the Detector server. See our implementation guide for simplified examples.

Be aware of our terms.

The API is available at http://detector-v3.dearapi.com.

Identification

http://detector-v3.dearapi.com/

Performs segment identification based on device useragent, with the purpose of returning segment as a HTML snippet.

Useragent defaults to requesting device but specific useragent can be sent using the ua parameter.

POST or GET parameters

ua: Optional useragent to be identified. Defaults to requesting device useragent.
site: Optional origin site. We recommend you to add this parameter to your request to provide better usage statistics.
file: Optional origin file. We recommend you to add this parameter to your request to provide better usage statistics.

Request

http://detector-v3.dearapi.com/

Returns HTML formatted segment.

<!DOCTYPE html>
<html>
<body>
<div id="device">
	<span id="segment" class="proporty">desktop_light</span>
</div>
</body>
</html>

Test this endpoint

http://detector-v3.dearapi.com/text

Performs segment identification based on device useragent, with the purpose of returning segment as a text string.

Useragent defaults to requesting device but specific useragent can be sent using the ua parameter.

POST or GET parameters

ua: Optional useragent to be identified. Defaults to requesting device useragent.
site: Optional origin site. We recommend you to add this parameter to your request to provide better usage statistics.
file: Optional origin file. We recommend you to add this parameter to your request to provide better usage statistics.

Request

http://detector-v3.dearapi.com/text

Returns text string segment.

desktop_light

Test this endpoint

http://detector-v3.dearapi.com/xml

Performs segment identification based on device useragent, with the purpose of returning segment as a XML snippet.

Useragent defaults to requesting device but specific useragent can be sent using the ua parameter.

POST or GET parameters

ua: Optional useragent to be identified. Defaults to requesting device useragent.
site: Optional origin site. We recommend you to add this parameter to your request to provide better usage statistics.
file: Optional origin file. We recommend you to add this parameter to your request to provide better usage statistics.

Request

http://detector-v3.dearapi.com/xml

Returns XML formatted segment.

<?xml version="1.0" encoding="UTF-8"?>
<device>
    <segment>desktop_light</segment>
</device>

Test this endpoint

http://detector-v3.dearapi.com/jsonp

Performs segment identification based on device useragent, with the purpose of returning segment to local callback function.

Useragent defaults to requesting device but specific useragent can be sent using the ua parameter.

POST or GET parameters

ua: Optional useragent to be identified. Defaults to requesting device useragent.
site: Optional origin site. We recommend you to add this parameter to your request to provide better usage statistics.
file: Optional origin file. We recommend you to add this parameter to your request to provide better usage statistics.
callback: Optional callback function. Defaults to "callback"

Request

http://detector-v3.dearapi.com/jsonp

Returns JSONP callback function with segment.

callback({"segment":"desktop_light"});

Test this endpoint

http://detector-v3.dearapi.com/js-include

Performs segment identification based on device useragent, with the purpose of returning appropriate segment without using local server-side technology. This method uses the original Detector/Janitor filenaming conventions.

Requesting page should save segment in client-side cookie to avoid making repeating requests from same browsing session.

Useragent defaults to requesting device but specific useragent can be sent using the ua parameter.

GET parameters

ua: Optional useragent to be identified. Defaults to requesting device useragent.
site: Optional origin site. We recommend you to add this parameter to your request to provide better usage statistics.
file: Optional origin file. We recommend you to add this parameter to your request to provide better usage statistics.
path: Optional general include path. Defaults to /js and /css.
css_path: Optional CSS include path.
css_param: Optional CSS include file parameter.
js_path: Optional JavaScript include path.
js_param: Optional JavaScript include file parameter.
dev: Optional development include. Will include /css/lib/seg_segment_include.css and /js/lib/seg_segment_include.js following the recommended structure from http://janitor.parentnode.dk.

Request

http://detector-v3.dearapi.com/js-include

Returns a JavaScript snippet with the appropriate JavaScript and CSS include statements.

document.write('<link type="text/css" rel="stylesheet" media="all" href="/css/seg_desktop_light.css" />');
document.write('<script type="text/javascript" src="/js/seg_desktop_light.js"></script>');

Test this endpoint

Submission

http://detector-v3.dearapi.com/submit

Submit useragent to Detectors indexing system. Useragents submitted here will be considered when the Detector core is updated.

GET parameters

ua: Useragent to be submitted.
site: Optional origin site. We recommend you to add this parameter to your request to provide better usage statistics.
file: Optional origin file. We recommend you to add this parameter to your request to provide better usage statistics.

Request

http://detector-v3.dearapi.com/submit

Returns

success

Build

http://detector-v3.dearapi.com/build

Build static Detector-v3, using the latest available data.

Add optional custom grouping of segments to make the detection return exactly what you need. See the build page for more information.

POST or GET parameters

language: Required - programming language to export detector v3 in.
grouping: Optional custom segment grouping as JSON object.

Supported languages

PHP, JavaScript. Java coming soon.

Grouping syntax

{
	"group-name":[
		"segment-name-1",
		"segment-name-2"
	]
}

Example

{
	"desktop":[
		"desktop_edge",
		"desktop_ie10",
		"desktop_ie11",
		"tablet"
	],
	"mobile":[
		"smartphone",
		"mobile",
		"tablet_light",
	],
	"unsupported":[
		"tv",
		"desktop_light",
		"desktop_ie9",
		"mobile_light"
	]
}

Returns static standalone Detector v4 class in specified language, where detection will result in one of 4 custom segments: desktop, mobile, unsupported and the unmentioned seo.

Debugging

http://detector-v3.dearapi.com/debug

Performs segment identification based on device useragent, but collects and sends additional information to the development team.

Useragent defaults to requesting device but specific useragent can be sent using the ua parameter.

POST or GET parameters

ua: Optional useragent to be identified. Defaults to requesting device useragent.

Request

http://detector-v3.dearapi.com/debug

Returns extended set of device details, and sends email with debug information to development team.

Detector v3 API Documentation

Identification

http://detector-v3.dearapi.com/

Request

http://detector-v3.dearapi.com/text

Request

http://detector-v3.dearapi.com/xml

Request

http://detector-v3.dearapi.com/jsonp

Request

http://detector-v3.dearapi.com/js-include

Request

Submission

http://detector-v3.dearapi.com/submit

Request

Build

http://detector-v3.dearapi.com/build

Supported languages

Grouping syntax

Example

Debugging

http://detector-v3.dearapi.com/debug

Request

Detector v3
API Documentation