使用说明

 适用SKY系列终端,包含SKY X510、SKY X310、SKY 310i、SKY 310、SKY D510i、SKY D510、SKY X700、SKY X500、SKY X300、SKY 300、SKY 100

 API使用必须先调用登陆接口(/mtapi/entity/connect)获取到userid之后,才能调用其他接口

 API使用须将发送的结构体填充完整,整个结构分为head和body两部分,body为API请求示例的内容,head为固定的几个参数如下:

 (特别说明:head部分五个字段必须全部包含)

字段

含义

sessionid

必填0

userid

调用登陆接口登陆成功之后的返回值

webapiversion

webapi版本号(必填2)(该字段为后续版本兼容使用)

seqid

填null

synchronous

后端接受消息之后是否立即响应(一般填true)

完整的结构(以登陆接口为例):

{
"head":
{
"sessionid":0,
"userid":"",
"webapiversion":2, //(必填)
"seqid":null,
"synchronous":true
},
"body":
{
"param1":
{
"basetype":"str" // Username
},
"param2":
{
"basetype":"str" // Password (MD5加密之后的结果)
},
"param3":
{
"basetype":true
},
"param4":
{
"basetype":"firefox"
}
}
}

 示例参数:

参数名称类型说明
param1string用户名
param2string密码(要md5加密后的结果,32位小写)
param3boolean是否要抢登(true,false)
param4string登陆浏览器类型(IE7,IE8,IE9,IE10,IE11,firefox,Opera,Safari,Chrome,Edge,other)

 返回结果:

{
"achCurUserIP" : "",
"achUserId" : "mDyFFTuOH1dHlwtHoEqbjHrKLDwUD22",
"achUserName" : "admin",
"bIsKickOut" : true,
"bLogin" :true,
"bNameExist" :true,
"bSameBrowser" :true,
"dwLoginErrCnt" :0,
"dwLoginTime" :0,
"dwUserRight" :1,
"emMtModel" :0,
}

 结果参数:

参数名称类型说明
achCurUserIPstring当前用户IP
achUserIdstring登录用户的userid
achUserNamestring用户名
bIsKickOutboolean是否有其他用户登录(true/false)
bLoginboolean登录结果(true:成功 false:失败)
bNameExistboolean登陆名是否存在(true/false)
bSameBrowserboolean是否使用相同浏览器登录(true/false)
dwLoginErrCntint登陆失败次数
dwLoginTimeint距离最近一次账号被锁定时间
dwUserRightint用户权限 1:管理员;2:操作员(默认)
emMtModelint终端类型

 注意事项:
1、emMtModel枚举值参考左上角枚举值汇总的EmMtModel_Api
2、参数说明中如果有是否字样表示该字段使用布尔值(0,1)或者(false,true)



©1997 - 2015 苏州科达科技股份有限公司 ,版权所有