用户授权管理

更新时间:2025-05-30 01:56:03下载pdf

API列表

请求方式 API 描述
POST /v1.0/iot-02/third/spaces/{device_id}/persons/{person_id} 新增用户授权
DELETE /v1.0/iot-02/third/spaces/{device_id}/persons/{person_id} 取消用户授权

新增用户授权

功能描述

​ 给创建的涂鸦用户授权门禁设备的权限, 有门禁权限的用户才能和门禁进行音视频对讲。

接口地址

POST /v1.0/iot-02/third/spaces/{device_id}/persons/{person_id}

请求参数

参数名 类型 参数类型 说明 必填
device_id String URI 涂鸦设备id
person_id String URI 涂鸦用户id

请求示例

POST /v1.0/iot-02/third/spaces/002dj00118fe34d9****/persons/ay1534*****4744oIAa

返回信息

参数名 类型 说明
code Integer 响应码(详情见错误码章节)
success Boolean 本次请求是否成功:(true:成功,false:失败)
msg String 请求失败的信息,成功为空
result Object 返回结果

result 说明

参数名 类型 说明
device_id String 涂鸦设备id
person_id String 涂鸦用户id

返回结果示例

{
    "success": true,
    "result": {
        "device_id": "002dj00118fe34d9****",
        "person_id": "ay1534*****4744oIAa"
    }
}

取消用户授权

功能描述

​ 取消用户的设备授权, 没有授权的用户将没有门禁的音视频对讲功能的权限。

接口地址

DELETE /v1.0/iot-02/third/spaces/{device_id}/persons/{person_id}

请求参数

参数名 类型 参数类型 说明 必填
device_id String URI 涂鸦设备id
person_id String URI 涂鸦用户id

请求示例

DELETE /v1.0/iot-02/third/spaces/002dj00118fe34d9****/persons/ay1534*****4744oIAa

返回信息

参数名 类型 说明
code Integer 响应码(详情见错误码章节)
success Boolean 本次请求是否成功:(true:成功,false:失败)
msg String 请求失败的信息,成功为空
result Object 返回结果

result 说明

参数名 类型 说明
device_id String 涂鸦设备id
person_id String 涂鸦用户id

返回结果示例

{
    "success": true,
    "result": {
        "device_id": "002dj00118fe34d9****",
        "person_id": "ay1534*****4744oIAa"
    }
}