获取访问令牌
https://cnapi.ttlock.com/oauth2/token // 当前接口域名请求中国站点,面向境外客户需要请求境外站点请在页面顶部切换语言。
云端接口采用OAuth 2.0的Resource Owner Password授权方式,开发者需要直接传入用户的账号和密码来获取访问令牌 ,所有云端接口都会校验访问令牌 以确定用户身份和权限。
注意:API参数里的username 和 password为通通锁app的账户密码,需要下载app进行注册,不是开发者账户的账户密码。
注意:获取的访问令牌会在返回的expires_in参数标识的秒数后过期(默认有效期90天),以过期的令牌请求接口会返回10004错误码,需要重新获取或刷新访问令牌 。
1 HTTP请求方法及示例
POST, ContentType:application/x-www-form-urlencoded
javascript
curl --location -g --request POST 'https://cnapi.ttlock.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=aXKx0UCGye7qbEOSAhST+IMCh9P22WFXK5mvXH8JmH55Of5/l9YszhPalvql5Ct419qohmb8oCdzgVtQk/HXlJzgwtNLmasZD43+WS2rlWcaX9GtDwpKsRemvNEgRDEIljlNFsS/xkTq17HeHoc/Z8y7JxjLBcfGoSPnobiuucZhSc7Zj/6qo40oYkaC1FuuNaxsmM7PazHTCer3hRENFuwRxC8HiOM5MEz1AP7M1VEyBavkwEQOH669ybWexvsKg/YHEWGwPCE/VMfu0pfyIVXqobQj6nEBKE3SadhlRXAxHPGCXZgkbJXZKuF22N55ZMolumC5BBWweXr1Bfmfkw=='2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的clientId |
| clientSecret | String | Y | 创建应用分配的clientSecret |
| username | String | Y | 通通锁APP的登录账号,也可以是注册用户接口返回的账号。注意:请别使用开发者账号。 |
| password | String | Y | 账号密码:先用MD5 加密(32位小写),再用RSA公钥做RSA加密,如明文密码:123456,MD5 加密后为e10adc3949ba59abbe56e057f20f883e, 再用RSA加密后为:aXKx0UCGye7qbEOSAhST+IMCh9P22WFXK5mvXH8JmH55Of5/l9YszhPalvql5Ct419qohmb8oCdzgVtQk/HXlJzgwtNLmasZD43+WS2rlWcaX9GtDwpKsRemvNEgRDEIljlNFsS/xkTq17HeHoc/Z8y7JxjLBcfGoSPnobiuucZhSc7Zj/6qo40oYkaC1FuuNaxsmM7PazHTCer3hRENFuwRxC8HiOM5MEz1AP7M1VEyBavkwEQOH669ybWexvsKg/YHEWGwPCE/VMfu0pfyIVXqobQj6nEBKE3SadhlRXAxHPGCXZgkbJXZKuF22N55ZMolumC5BBWweXr1Bfmfkw== |
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}