Previous topicNext topic
 万捷网络验证系统在线帮助文档
Help > WebApi接口说明 >
zx - 控制在线状态

注意:

 1、必须是用WebApi接口 login 进行登录的软件才可以使用此功,非WebApi接口登录的禁止使用此功能,否则会造成已经登录的软件被踢掉。
 2、此功能适用于,需要控制用户本地或异地登录数量时使用,无论是1开还是N开,无论是本地还是异地,都可以通过此接口来控制用户的登录数量。

接口原型:

$data = zx([软件编号],[用户账号],[用户密码],[在线标识],[需要删除标识],[操作类型]);//返回执行结果

 接口名称  说明
zx                                        控制用户账号本地和异地登录软件的数量
 参数  说明
参数1:软件编号 软件的编号,如:10001
参数2:用户账号 用户账号
参数3:用户密码 用户密码的小写32位MD5,卡号直接登录的留空
参数4:在线标识 GUID(全球唯一标志),数字和字母组成,最大长度16,在任何软件和时间内不出现重复。
参数5:需要删除标识 需要删除的在线标识,当用户软件意外退出导致的在线标识没有被删除 ,为了防止顶掉正常的在线标识,所以需要把意外退出的标识删掉(当参数6为0时,将此标识写到本地文件,当参数6为2时将本地文件删除,下次参数6为0时,检测本地文件是否存在在线标识记录,如果有记录的话就把这个本地在线标识一起提交,这样就会增加新在线标识,删除旧标识,保证软件在线数量的准确性,防止在线的软件被踢掉),可空。
参数6:操作类型

0= 增加在线标识,调用Login接口登录成功后,使用此功能增加软件的在线标识,如果在线标识数量超出用户允许登录软件的数量,则会删掉激活时间最早的在线标识(参数6的值为1时,将会刷新在线标识的激活时间到当前时间

1= 检测在线标识,软件登录成功后,软件正常运行的情况下,循环调用此功能来检测软件是否合法和用户账号的封停、到期、被删除等状态。

2= 删除在线标识,软件退出的时候执行此操作,删除在线标识,表示软件已经退出了,为相同账号登录其他软件时空出允许登录的数量 。

3= 查询用户在线标识数量,这个功能一般用不到,显示账号登录软件的大概数量。

执行结果返回值: 

0 = 在线标识不存在,表示用户超出允许登录数量在线标识被删除了,或者用户登录成功后没有成功添加在线标识
 1 = 增加标识成功、在线标识正常、删除标识成功(对应参数6的值分别为 0 1 2 时操作成功的值)
 2 = 当参数6为0,增加新在线标识的时候,如果标识存在了,就会返回这个值
 -1 = 账号不存在
 -2 = 账号已经过期
 -3 = 账号被封
 -4 = 密码错误
 -100=未知错误,如:数据库故障、系统故障、文件损坏等问题造成的错误
 参数6为3时,返回账号在线标识的数量(不保证准确,因为有软件意外退出没删除在线标识的情况)

访问示例:

http://服务器地址/api.php?name=接口名称&c1=软件编号&c2=账号&c3=密码&c4=在线标识&c5=需要删除标识&c6=操作类型

在WebApi接口中的调用方法(将下面的代码复制到后台的WebApi代码框中):

function  zdy_ApiName($rjbh,$user,$md5pass,$sbm,$sbm2,$lx){//请将ApiName改为您自己想要定义的任意名称

$data=zx($rjbh,$user,$md5pass,$sbm,$sbm2,$lx);

return $data;

}