1.3.1 签名算法
待加密串为该次请求中的appKey、clientTime、version,以&连接的字符串,按参数的字母先后顺序排序,再连接appSecret如
appKey=ap119jaz6b6te84v&clientTime=1465180217306&version=V1.0&yhegf6ehllfegayh3bem6l3gvswp2r50
得到和字符串经MD5加密,最后再进行SHA1加密,得到signature
其中, appKey和appSecret的获取,见1.1 开放平台说明接入方式和说明。
签名算法,详细见1.3.4demo代码。
1.3.2 获取ticket
(1)方法 api/users/ticket Get接口
(2)接口参数
参数 说明 类型 是否必须
appKey App Key String Y 开发者账号创建授权接入
clientTime 访问时间毫秒数 Int Y在30分钟内有效
version 客户端版本 String Y 固定值V1.0
signature 签名串 String Y
签名串生成规则见1.3.1签名算法
(3) 示例 https://api.wojiacloud.com/api/users/ticket?appKey=ap119jaz6b6te84v&clientTime=1465180217306&version=V1.0&signature=034AE27C333F41CAB37C044A3BC76E25B9FEA7FB
(4) 返回结果
{
“result”: ‘success‘,
“success”: true|false,
“ code”:0|1002” ,
“ msg”: null|”
"data":{
"ticket ": "nrb8ffrg23230wfywv6bpagkomkgfb",
"expires": 7200
}
}
ticket有效时间2小时,超时需要重新获取。 重新获取后,原ticket失效。
ticket获取需要在开发者服务端获取,我家云会校验白名单。
1.3.3 获取access_token
(1)方法 api/users/access_token
POST接口
(2)接口参数
参数 说明 类型 是否必须
ticket 有效票据 String 1.3.2接口获得
username 用户名 String 用户手机号phone ,必须
pid 小区Id String 小区Id 必须
type 用户类别 String 0物业后台 1 住户APP 2管家APP 3接口获取 必须
(3) 示例 https://api.wojiacloud.com/api/users/access_token
(4) 返回结果
{
“result”:'success',
“success”: true|false,
“ code”:0 ,
“ msg”: ""
"data":{
"access_token": "nrb8ffrgsx9cy40wfywv6bpagkomkgfb" ,
"expires": 7200
}
}
access_token有效时间2小时,超时需要重新获取。 重新获取后,原access_token失效。
access_token获取需要在开发者服务端获取,我家云会校验白名单。
1.3.4 demo
1.3.5 通知
(1)方法 api/users/notice Get接口
如果获取access_token接口失败, 那么请调用此接口,会通知我家云管理员 即时响应解决。
(2)接口参数
参数 说明 类型 是否必须
appKey App Key String Y 开发者账号创建授权接入
clientTime 访问时间毫秒数 Int Y在30分钟内有效
version 客户端版本 String Y 固定值V1.0
signature 签名串 String Y
签名串生成规则见1.3.1签名算法(同 ticket接口算法)
(3) 示例 https://api.wojiacloud.com/api/users/notice ?appKey=ap119jaz6b6te84v&clientTime=1465180217306&version=V1.0&signature=034AE27C333F41CAB37C044A3BC76E25B9FEA7FB
(4) 返回结果
{
“result”: ‘success‘,
“success”: true|false,
“ code”:0|1002” ,
“ msg”: null|”
"data":{
}
}