Skip to content

获取访问令牌 ​

https://cnapi.ttlock.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.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=e10adc3949ba59abbe56e057f20f883e'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的clientId
clientSecretStringY创建应用分配的clientSecret
usernameStringY通通锁APP的登录账号,也可以是注册用户接口返回的账号。注意:请勿使用开发者账号。
passwordStringY通通锁App密码(需传 md5 加密后的值,32位小写)

注意:API参数里的username 和 password为通通锁app的账户密码,需要下载app进行注册,不是开发者账户的账户密码。

3 返回参数及示例 ​

参数类型描述
access_tokenString访问令牌
uidInt用户主键id
expires_inInt访问令牌过期时间,默认90天,单位秒
refresh_tokenString刷新令牌
{
    "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值是否正确

image-20261104102436940