IPCloak官方网站 | Cloak技术原创者 | Facebook广告规避 | Google广告规避 | Yahoo广告规避
咨询热线
Cloak技术的首创者

13826051995

API接口说明

如果您希望通过我们的cloak系统来判断IP是否属于您的广告目标客户,您可以调用API接口,我们会判断然后返回判断结果给您

我们仅提供php语言的接口调用文件,其他语言java, javascript 的接口调用方法只提供示例,需要您自行开发。 如有需要,可联系QQ: 2605871098,微信: 13826051995

1.请求方式:POST

2.接口地址:正式开通账号后向客服索取

请求参数

参数 类型 必需 示例 描述
username 字符串 必传 123456789 用户名(正常用户名为手机号或QQ号)
password 字符串 必传 ******** 用户密码(16位大小写字母和数字的组合)
ip 字符串 必传 192.168.1.1 提交判断的IP地址(支持ipv4和ipv6)
site 字符串 可不传 $_SERVER['HTTP_HOST'] 调用接口的网站
device 字符串 可不传 '' 当前访问设备(手机:phone, 平板:tablet, 电脑:computer, '': 表示不传递设备值),默认为空
ads_countries 字符串 可不传 'US+GB+CA' 打广告的国家, 一定要填写2位国家代码,多个国家之间用+号连接,国家代码务必参见 国家代码
ban_devices 字符串 可不传 'computer+tablet' 屏蔽设备,参数值:phone(手机),tablet(平板),computer(电脑),默认为空表示不屏蔽任何设备。
ban_agent bool值 可不传 true true:屏蔽代理; false: 允许代理IP访问, 默认true
ip_whitelist 字符串 可不传 '192.168.1.2+192.168.1.3' 允许访问仿品或者黑五页面的ip白名单,多个ip之间用+号连接

接口返回的json数据

参数 数据类型 示例 描述
status 数字 0 0:表示此IP被屏蔽;1:表示此IP审核通过。客户根据0和1的值来做相应处理,比如0显示ZP,1显示FP。
reason 字符串 108.ads_platform_prohibited 108表示错误代码;ads_platform_prohibited表示错误代码的英文解释,此值表示广告平台IP被屏蔽

php示例代码

// 直接调用ipcloak接口  	
$jsonData = array();		
$jsonData['username'] = "cloak用户名";
$jsonData['password'] = "cloak密码";	
$jsonData['ip'] = $ip; // 调用接口的IP地址,也就是访问你网站的客户的IP地址
$jsonData['device'] = detectAgent(); // 调用接口的设备
$jsonData['site'] = $_SERVER['HTTP_HOST']; // 调用接口的网站地址
$jsonData['ads_countries'] = ''; // US+CA+GB 打广告的国家: 美国+加拿大+英国, 国家代码参见:http://www.ipcloak.com/country.html
$jsonData['ban_agent'] = true; // 默认屏蔽代理
$jsonData['ban_devices'] =''; // 屏蔽访问设备, phone,tablet,computer, 多个设备用+号相连,例如:tablet+computer 表示屏蔽平板和台式电脑。	
$jsonData['ip_whitelist'] = "192.168.1.2+192.168.1.3"; // IP白名单,做测试的时候使用,多个ip地址用+号相连	
	
// 调用cloak API 接口
$ch = curl_init('https://www.******.com/api/index.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($jsonData));	
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  // 关闭SSL验证, 如果测试接口返回数据为null, 请去掉此行和下面一行代码前面的注释
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
	
$return = curl_exec($ch);// 执行curl调用远程API接口
if(curl_errno($ch)){// 检查是否有错误发生
    echo 'Curl error: ' . curl_error($ch);
}	
curl_close($ch);// 关闭句柄

$result = json_decode($return, true); // json数据解码成数组	
// var_dump($result); exit; // 调试语句
$status = $result['status']; // 返回false可以访问正品,返回true可以访问黑五

if($status){ // $status==1: 表示客户可以看到仿品
	$show_url = "广告目标客户看到的仿品或者黑五页面地址";
	$show_data = curl_get_content($show_url);
	if(substr($show_url,-1)!="/"){ $show_url .= "/"; }
	$show_data = str_replace('', '', $show_data); // 独立站css和js资源加载失败的话,请去掉注释//, 启用这行代码
	echo $show_data; // 显示抓取到的页面内容
	// 默认使用抓取内容的方式显示仿品或者黑五页面,如果页面版面格式乱了的话则注销上面一句代码,启用下面一句强制跳转代码
	// header("Location:".$show_url);
	exit;
}