开放平台 / 概述 / 1.3 授权接口

1.3 授权接口


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

demo限于java语言实现


签名算法




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":{                        

                             

    }

}