提交自定义API授权记录

历史版本

• 提交自定义api授权记录

请求路径

• 请求方式：POST
• 请求头：Content-Type:application/json
• 接口地址：https://gateway.nuoyunapi.com/Api/Room/addRoomLimitRecord/2.0.0
• 频率限制：10秒1000次

说明

• 直播间-频道限制-自定义api授权场景下，提交用户信息到授权名单
• 未使用直播间频道限制规则进行过滤
• 仅做重复提交验证
• 第三方系统用户唯一标识可选

请求参数

参数	必选	类型	描述
room_id	是	integer	直播间ID
wechat_user_space_id	是	integer	用户ID
third_id	否	string	第三方平台用户id

请求示例

示例1：提交用户授权记录

{
    "room_id": 123456789,
    "wechat_user_space_id": 987654321,
    "third_id": ""
}

示例2：提交带第三方ID的授权记录

{
    "room_id": 123456789,
    "wechat_user_space_id": 987654321,
    "third_id": "user_123456"
}

响应参数

参数	必选	类型	描述
code	是	integer	状态码：200-成功，400-失败
msg	是	string	提示信息
data	是	object	响应数据

响应示例

成功响应示例

{
    "code": 200,
    "msg": "Success",
    "data": {}
}

错误响应示例

{
    "code": 400,
    "msg": "直播间ID不能为空",
    "data": {}
}

重复提交示例

{
    "code": 400,
    "msg": "该用户已在授权名单中",
    "data": {}
}

状态码说明

状态码	描述
200	成功
400	失败

使用说明

1. 该接口用于在直播间频道限制场景下，将用户添加到自定义API授权名单
2. 提交后用户将获得该直播间的访问权限
3. 支持第三方系统用户唯一标识，便于跨系统用户管理
4. 系统会自动验证重复提交，避免重复授权
5. 接口需要有效的认证信息才能调用