【可可网络验证系统】实现安全的网络验证功能，是您软件收费的好助手。

网站首页 软件简介 产品展示 购前试用 下载软件 售后服务

 
什么是服务端高级API
  
什么是服务端高级API[2014-03-18]

服务端高级API是应答客户端ks_advapi接口的专用接口。
客户端ks_advapi接口必须在服务端有相应的服务端高级API才可以使用。
服务端高级API在软件参数设置的高级API选项卡里边，使用的是标准php语法。
客户端ks_advapi发送数据过来时，服务端会先效验用户身份，然后才会执行相应的高级API接口。
高级API接口可操作数据库，可对数据进行加密，可实现自己的加解密算法。
如果开发自己的加解密算法时必须注意的是高级API的字符编码是utf-8

内置函数：api_get
  
内置函数：api_get[2014-03-18]

M06-P103及以上的版本才有此内置函数。
	$resulr=api_get(要读取的属性名) 
	作用：读取当前用户某项属性的值
	读取失败返回字符串 par1err
	要读取的属性名为枚举格式，可以用以下字符串：
		'当前IP'　　:	当前用户连接的IP，是一个长整型数值
		'用户名'　　:	不解释。。
		'锁'　　　　:   整数串   '0'未锁定  '1'代理锁  '2'总代锁  '3'作者锁
		'用户密码'　:	不解释。。
		'安全密码'　:	不解释。。
		'标签'　　　:	不解释。。
		'登陆次数'　:	不解释。。
		'备注'　　　:	不解释。。
		'天数'　　　:	用户列表里用户的天数，不是剩余天数
		'点数'　　　:	不解释。。
		'附属性'　　:	不解释。。
		'机器码'　　:	不解释。。
		'私有数据'　:	不解释。。
		'绑定信息'　:	不解释。。
		'上一次IP'　:	上一次该用户连接服务端时的IP
		
	示例： 	 
		function v_testget1(){
			$result=api_get('机器码');   //那$result就是当前连接用户存放于数据库中的机器码
			return $result;  
		}  
	 客户端可以  ks_advapi("v_testget1")来取该接口的数据
	 
内置函数：api_set
	 
内置函数：api_set[2014-03-18]

M06-P103及以上的版本才有此内置函数。
 $result=api_set(要设置值的属性名,要设置的值)
	作用：修改当前用户某项属性的值
	修改成功返回逻辑值true，失败返回的是具体错误信息字符串
	要设置值的属性名为枚举格式，可以用以下字符串：
		'锁'　　　　:	整数串，'0'未锁定 '1'锁定代理可解锁  '2'锁定总代和作者可解锁  '3'锁定只有作者才可以解锁
		'标签'　　　:	100字符限制
		'备注'　　　:	50字符限制
		'天数'　　　:	小数点后可带两位  '5' '5.02' 均可
		'点数'　　　:	整数
		'附属性'　　:	128字符限制
		
		'机器码'　　:	128字符限制
		'私有数据'　:	128字符限制
		'绑定信息'　:	100字符限制
	示例：  
		将当前用户的私有数据改为  abcdefg  
		function v_testset1(){
			$result=api_set('私有数据','abcdefg');   
			if($result!==true){
				return '修改数据出错:'.$result; 
			}else{
				return '修改数据成功';
			}
		} 

内置函数：encode_rsa
	
内置函数：encode_rsa[2014-03-18]

$result=encode_rsa($text,$rsa_prvkey,$rsa_modulus);
参数一$text为待加密的数据，长度要小于20字节；
参数二$rsa_prvkey为RSA加密的私钥；
参数三$rsa_modulus为RSA加密的模；
加密的结果在客户端可以通过API接口  decode_rsa来解密，客户端里只能使用公钥对数据解密
服务端使用encode_rsa用私钥对数据加密，相应客户端调用decode_rsa时用公钥对数据进行解密
RSA密钥对的获取与设置说明

举例:
假设有服务端代码
function v_mydata01(){
$a=encode_rsa('FFE412AE','RSA私钥数据','RSA模数');
return $a;
}
客户端就可以调用
decode_rsa(ks_advapi("v_mydata01"),"RSA公钥数据","RSA模数") 来获取 FFE412AE

内置函数：encode_RC4Base64
	
内置函数：encode_RC4Base64[2014-03-18]

RC4和Base64的混合加密算法函数
$result=encode_RC4Base64($key,$text)
参数$key为密钥，参数$text为待加密的数据，$result为加密后的结果。
客户端可通过 decode_RC4Base64(密钥，加密后的文本) 来解密。

示例：
服务端使用服务端内置函数encode_RC4Base64用密钥对数据加密，相应客户端调用API：decode_RC4Base64对数据进行解密
举例:
假设有服务端代码
function v_mydata02(){
$a=encode_RC4Base64('ABCDEFjuiower','mydata888888');
return $a;
}
客户端就可以调用
decode_RC4Base64('ABCDEFjuiower',ks_advapi("v_mydata02")) 来获取 mydata888888
上边列举的是最基本的用法，具体使用方式还请自行变通。
 
内置函数：make_key
内置函数：make_key[2014-03-18]

make_key() 用于生成一个20位的随机字符串，可用于RC4Base64的密钥

示例    
function v_*****(){
	$mykey=make_key();
	...
	...
	return '*****';
}
那么$mykey就是一个长为20的字符串。