更新用户时效

更新时间:2023-12-07 03:33:50下载pdf

本文介绍更新用户时效的 API。

接口描述

更新门锁上的用户时效,下发时效信息到门锁。

接口地址

PUT: /v1.0/smart-lock/devices/{device_id}/users/{user_id}/schedule

请求参数

参数名 类型 参数位置 是否必填 说明
device_id String uri true 设备 ID
user_id String uri true 用户 ID

body 说明

参数名 类型 参数位置 是否必填 说明
permanent Boolean false 是否永久
effective_time Long false 生效时间(单位为秒)
expired_time Long false 失效时间(单位为秒)
schedule_details List false 时效周期性信息

schedule_details 说明

参数名 类型 参数位置 是否必填 说明
start_minute Long false 一天里开始生效分钟
end_minute Long false 一天里开始失效分钟
working_day Integer false 星期, 每个值累加:
  • 1:星期天
  • 2:星期一
  • 4:星期二
  • 8:星期三
  • 16:星期四
  • 32:星期五
  • 64:星期六
time_zone_id String false 时区
all_day Boolean false 是否全天

返回参数

参数名 类型 说明
result Boolean 用户时效是否更新成功

请求示例

PUT: /v1.0/smart-lock/devices/vdevo12454656****/users/130**/schedule
{ "scheduleDetails": [ { "allDay": false, "start_minute": "420", "end_minute": "1438", "workingDay": 99 } ], "effectiveTime": 1628179200, "expiredTime": 1640015999, "permanent": false }

返回示例

{ "result": true, "t": 1628233659275, "success": true }

错误码

参考 错误码