IPCloak官方网站 | Cloak技术真正首创者 | Facebook广告规避系统 | Bing广告规避系统 | Yahoo广告规避系统 | 海外推广利器
咨询热线
7*24小时在线咨询:

13826051995

接口说明

接口说明

使用接口前,请务必联系我们开通测试账号,支持php, java, asp 3种语言调用。 如有需要,可联系QQ: 2605871098,电话: 13826051995(微信同步)

1.请求方式:POST

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

请求参数

参数 数据类型 必需 示例 描述
username 字符串 123456789 用户名(正常用户名为手机号或QQ号)
password 字符串 123456789 用户密码(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访问, 默认屏蔽
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被屏蔽

3. php示例代码

/* 调用接口的php示例代码 */

	$jsonData = array();
	$jsonData['username'] = "用户名";
	$jsonData['password'] = "密码";
	$jsonData['cloak_id'] = 0; // 我们后台设置的cloak页面ID, 切记!!!如果这里设置为0的话,则cloak参数以文件里传递的为准,如果设置为某个固定值的话则以后台设置的为准。
	$jsonData['ip'] = $ip;
	$jsonData['site'] = $_SERVER['HTTP_HOST']; // [HTTP_HOST] => www.gzsale.com + [PHP_SELF] => /onepage/test.php (调用网站路径包含到最后一个子文件夹)
	$jsonData['device'] = detectAgent(); // 必传参数,获取访问设备, 默认为空,表示不判断此项条件	
	$jsonData['ads_countries'] = ''; // US+CA+GB 打广告的国家: 美国+加拿大+英国, 国家代码参见:http://www.ipcloak.com/country_code.html
	$jsonData['ban_devices'] =''; // 屏蔽访问设备, phone=手机,tablet=平板电脑,computer=台式电脑和笔记本电脑, 多个设备用+号相连,例如:tablet+computer 表示屏蔽平板和台式电脑。
	$jsonData['ban_agent'] = true; // 是否屏蔽VPN代理	
	$jsonData['ip_whitelist'] = "192.168.1.2+192.168.1.3"; // IP白名单,做测试的时候使用	
	
	// 调用cloak API 接口
	$ch = curl_init('接口地址');
	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数据解码成数组
	$status = $result['status']; // 返回false可以访问正品,返回true可以访问黑五	
	setcookie('ip_token', ($status ? $fp_cookie_value : $zp_cookie_value), time() + 60 * 60 * 24 * 180, '/', '', false);	

// $status==0: 表示客户只能够看正品;$status==1: 表示客户可以看到仿品, 网站部署的时候一定要正品在根目录,仿品在子目录,遵循默认打开网站是先正品后仿品的顺序
if($status){
	if(isset($_SESSION['jump_url'])){
		$jump_url = $_SESSION['jump_url'];
	}else{
		if(file_exists("ipcloak.txt")){
			$get_file_str = file_get_contents("ipcloak.txt");//将整个文件内容读入到一个字符串中
			$jump_url = str_replace("\r\n","",$get_file_str);
			$_SESSION['jump_url'] = $jump_url;
		}else{
			$http_header = ((isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == 'on') || (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] == 'https')) ? 'https://' : 'http://'; 
			$jump_url = $http_header. $_SERVER['SERVER_NAME'] . "/fp/index.html"; // 后台和文件里都没有设置跳网址的话,则再这里手动指定跳转网站为根目录下的【/fp/index.html】文件
		}
	}
	$jump_fp_data = curl_get_content($jump_url);
	$jump_fp_data = str_replace('', '', $jump_fp_data);
	echo $jump_fp_data;	// 显示抓取到的仿品或者黑五页面内容
	exit;
}
// curl抓取仿品页面的内容
function curl_get_content($url) {
    $curl = curl_init();                     
    curl_setopt($curl, CURLOPT_URL, $url);  
    curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 30);     
    curl_setopt($curl, CURLOPT_HEADER, 0);            //不取得返回头信息
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); 
    curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 3);
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);//忽略服务https证书
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);//忽略客户https证书
    $data = curl_exec($curl);  
    curl_close($curl);           
    return $data;
}