Skip to content

创建签到板部署码

创建一个范围内的签到板部署码

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/vc/v1/room_configs/set_checkboard_access_code
HTTP MethodPOST
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用vc:room 更新视频会议室信息

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

请求体

名称类型必填描述
scopeint设置节点范围
示例值:5
可选值有
- 1: 租户 - 2: 国家/地区 - 3: 城市 - 4: 建筑 - 5: 楼层 - 6: 会议室
country_idstring国家/地区ID scope为2,3时需要此参数
示例值:"1"
district_idstring城市ID scope为3时需要此参数
示例值:"2"
building_idstring建筑ID scope为4,5时需要此参数
示例值:"3"
floor_namestring楼层 scope为5时需要此参数
示例值:"4"
room_idstring会议室ID scope为6时需要此参数
示例值:"67687262867363"
valid_dayint有效天数
示例值:1
可选值有
- 1: 1天 - 7: 7天 - 30: 30天

请求体示例

json
{
    "scope": 5,
    "country_id": "1",
    "district_id": "2",
    "building_id": "3",
    "floor_name": "4",
    "room_id": "67687262867363",
    "valid_day": 1
}

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ access_codestring部署访问码

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "access_code": "YNMLTJOUZ"
    }
}

错误码

HTTP状态码错误码描述排查建议
500121001internal error服务器内部错误,如果重试无效可联系管理员
400121002not support暂不支持该功能
400121003param error参数错误,检查参数的取值范围(请按照上面字段说明自查)
404121004data not exist无效的请求体,请确保请求方法、请求信息、请求数据格式等是正确的

内容来源:飞书开放平台 · 自动爬取整理