获取访问令牌
https://cnapi.sciener.com/oauth2/token // 当前接口域名请求中国站点,面向境外客户需要请求境外站点请在页面顶部切换语言。
云端接口采用OAuth 2.0的Resource Owner Password授权方式,开发者需要直接传入用户的账号和密码来获取访问令牌 ,所有云端接口都会校验访问令牌 以确定用户身份和权限。
**注意:**获取的访问令牌会在返回的expires_in参数标识的秒数后过期(默认有效期90天),以过期的令牌请求接口会返回10004错误码,需要重新获取或刷新访问令牌 。
1 HTTP请求方法及示例
POST, ContentType:application/x-www-form-urlencoded
javascript
curl --location -g --request POST 'https://cnapi.sciener.com/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'clientId=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--data-urlencode 'clientSecret=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--data-urlencode 'username=+8618966498228' \
--data-urlencode 'password=e10adc3949ba59abbe56e057f20f883e'2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的clientId |
| clientSecret | String | Y | 创建应用分配的clientSecret |
| username | String | Y | 通通锁APP的登录账号,也可以是注册用户接口返回的账号。注意:请勿使用开发者账号。 |
| password | String | Y | 通通锁App密码(需传 md5 加密后的值,32位小写) |
注意:API参数里的username 和 password为通通锁app的账户密码,需要下载app进行注册,不是开发者账户的账户密码。
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| access_token | String | 访问令牌 |
| uid | Int | 用户主键id |
| expires_in | Int | 访问令牌过期时间,默认90天,单位秒 |
| refresh_token | String | 刷新令牌 |
{
"access_token": "39caac89b0b51c980aa61ad4264b693b",
"uid": 2340,
"refresh_token": "1bd2a21a7df889630f444364813738d7",
"expires_in": 7776000,
}对接示例
通通锁App对接示例:通通锁app对接示例--FAQ
伴云来(通通酒店)对接示例:通通酒店app对接示例--FAQ
Error code 10007,"errmsg":"invalid account or invalid password"
1.请检查是否使用的是通通锁app账户,注意:请不要使用开发者账户;
2.请检查是否能够通过账户信息登录通通锁App
3.检查加密后的MD5值是否正确

