Custom Integrations - List Device Trackers Documentation

You can request a list of a user's device trackers by domain, based on the Device Fingerprint service.

Calling Refresh

https://www.ipqualityscore.com/webhooks/ExampleIntegration/json/device_trackers

Request Parameters

Parameter	Description	Example Value / Format
key	Your site's domain or the domain that requested this integration. REQUIRED	google.com
secret	Your user's current secret created during the authentication process. REQUIRED	char(128)
domain	The domain you wish to fetch trackers for. If this parameter is not passed defaults to your domain.	yahoo.com

Result

The HTML response will look like the screenshot below: Device Fingerprint Trackers

The JSON response will have the following data points:

Parameter

Description

Example Value / Format

message

Description of the status of this call. May contain errors if errors exist.

text

success

Boolean result of if the request was successful or not.

boolean

device_trackers

A list of this user's device trackers based on the domain requested.

Parameter	Description	Example Value / Format
name	A description of the device tracker in question (usually the domain, but can be changed by the user).	text
domain	The domain this tracker was created for.	text, domain
script_url	The JavaScript URL for this tracker.	text, URL
pixel_url	The image pixel URL for this tracker.	text, URL

Array of objects

Example Code


// URL for this request.
$URL = 'https://www.ipqualityscore.com/webhooks/ExampleIntegration/json/device_trackers';

// Configuration items for this request. NOTE: $secret will be user specific not application specific.
$key = 'example.com';
$secret = 'WkYwHzjeWMqGBuJKBA98Ko63arm3Cd6n3gwfucxaldFPyflJQ4X4oYmaHZmEudy7RGzF3v7I8GCVvaPpCBbsJD17XdGWYSunc8dmpvbxkH6QlcT5SxuH2pmt2Dhu4cDM';

// Prepare POST fields.
$fields = array(
	'secret' => $secret,
	'key' => $key
);
	
// Create CURL.
$curl = curl_init();
	
// Configure CURL
curl_setopt($curl, CURLOPT_URL, $URL);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($curl, CURLOPT_POST, 1);

// Set POST Parameters
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($fields));

// Fetch URL
$result = curl_exec($curl);

// GET response code.
$response_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);

// Close CURL
curl_close($curl);
	
// Handle result.
if((int) $response_code === 200){
	// JSON Decode
	$output = json_decode($result, true);
	
	// Do something with the response.
} else {
	echo "There appears to be an unforeseen error. Please contact IPQualityScore support if this persists.";
}