To integrate with other services and applications, we recommend setting up integration via Zapier.
You will be able to transfer data between services without the help of programmers.
Learn more about integration via Zapier

This method is out-of-date.  

Use GetLeadGroupStatuses instead.

You can get the contact groups list by requesting a query to the API service by software methods using their email. In response, your system will receive an array. There for each group will be transferred a group ID and a group name.

The query is sent by the POST method in the URLencode format to the address:  https://username.justclick.io/api/GetLeadGroups.

Where username is the login of the user to the system, as well as their domain of the third level in the JustClick service.

Parameters Transferred in the Query

  • email is the subscriber’s e-mail, that you need to get the current groups list (required)

The one and only field is the email field.

How Does It Work?

You transfer the client email to the GetLeadGroups API function. Your system will receive the result of the function-performing and an array with subscription groups in the result variable in response.

The groups array will look as follows:

$resp->result = Array (

[0] => array (
[rass_name] => Group 1 ID
[rass_title] => Group 1 Name
)

[1] => array (
[rass_name] => Group 2 ID
[rass_title] => Group 2 Name
)

[2] => array (
[rass_name] => Group 3 ID
[rass_title] => Group 3 Name

The response is coded in JSON format. For more details, see the “API Service Responses”.

Example of Getting a Subscription Groups List in PHP

We get subscription groups for the user with the email [email protected] in the example. Your username in the system is “username”.

GetHash Function forms the hash to the transferred data.

CheckHash Function checks the hash to the service response.

// Login to the JustClick system.
 $user_rs['user_id'] = 'username';
  // The key for forming a hash. See API section (the link in the bottom right corner of the personal account)
 $user_rs['user_rps_key'] = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
 
 // Forming the data array for transferring to the API
$send_data['email'] = '[email protected]'; // Client email, that we get the subscription groups list from
 
// Forming the hash to the transmitted data
$send_data['hash'] = GetHash($send_data, $user_rs);
 
// Calling the GetLeadGroups function and decoding the received data
$resp = json_decode(Send('https://username.justclick.io/api/GetLeadGroups', $send_data));
 
// Checking the service response
if(!CheckHash($resp, $user_rs)){
	echo "Error! The response hash is not true!" ; print_r($resp);
	exit;
}
 
if($resp->error_code == 0){
echo “Group List”;
print_r($resp->result);
}
else
	echo "Error code: {$resp->error_code} - description: {$resp->error_text}";
 
// =========== Functions of sending, receiving and processing a response ============
 
// Sending the query to the API service
function Send($url, $data)
{
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
	curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // outputting the response to the variable. 
 
	$res = curl_exec($ch);
 
	curl_close($ch);
	return $res;
}
 
// Forming the transferred to the API data hash
function GetHash($params, $user_rs) {
	$params = http_build_query($params);
	$user_id = $user_rs['user_id'];
	$secret = $user_rs['user_rps_key'];
	$params = "$params::$user_id::$secret";
	return md5($params);
}
 
// Checking the received response hash
function CheckHash($resp, $user_rs) {
	$secret = $user_rs['user_rps_key'];
	$code = $resp->error_code;
	$text = $resp->error_text;
	$hash = md5("$code::$text::$secret");
	if($hash == $resp->hash)
		return true; // the hash is correct
	else
		return false; // the hash is not correct
}

Rate article

1 star2 stars3 stars4 stars5 stars (1 votes, avr.: 1.00 / 5)
Loading...