Skip to content

锁初始化 ​

https://cnapi.ttlock.com/v3/lock/initialize

注意:调用该接口前,锁必需先由APP SDK初始化完成,lockData 锁数据必需来源于APP SDK锁初始化接口的回调。

锁初始化接口将锁相关的数据在服务端做初始化,同时会为调用该接口的用户生成一把管理员钥匙。

锁初始化成功后,管理员钥匙拥有者就可以给其他用户发送普通钥匙或是发送密码了。

如果已经使用通通锁APP添加锁,则不需要调用该接口,因为锁已经初始化完成,调用获取名下锁列表接口去获取已经初始化好的锁,调用其他接口需要的lockId也可以在通通锁APP的锁 【设置->基本信息】页面查看,如下图所示:

lockInfo

1 HTTP请求方法及示例 ​

POST, ContentType:application/x-www-form-urlencoded

javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/lock/initialize' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockAlias=阳光小区1-4-201' \
--data-urlencode 'lockData=xxxxxxxxxxxxx' \
--data-urlencode 'date=1625025703000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockDataStringY锁数据,必需由APP SDK锁初始接口生成。
lockAliasStringN锁别名
groupIdIntN分组ID,参考新增分组接口
nbInitSuccessIntNNB-IoT锁是否初始化成功,1-是、0-否,只有NB-IoT锁需要传
dateLongY当前时间(时间戳,单位毫秒)

3 返回参数及示例 ​

参数类型描述
lockIdInt锁ID
keyIdInt管理员钥匙id
{
    "lockId": 123132, 
    "keyId": "2342342"
}