Skip to content

添加分组 ​

https://cnapi.ttlock.com/v3/group/add

新增一个分组,分组用于对用户名下的锁和钥匙进行归类。 初始化锁时可以传分组ID,把锁添加到某一个分组,也可以后续再设置钥匙或锁所属的分组。 获取名下锁列表和获取名下钥匙列表接口可以通过分组ID来获取某个分组下的锁或钥匙。

1 HTTP请求方法及示例 ​

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

javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/group/add' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'name=山水一栋' \
--data-urlencode 'date=1625025703000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
nameStringY分组名称
dateLongY当前时间(时间戳,单位毫秒)

3 返回参数及示例 ​

参数类型描述
groupIdInt分组ID
{
    "groupId": 1342
}