腾讯会议REST API X-TC-Registered参数策略更新通知

liquid

发布于 2021-08-26 15:23:28

9360

发布于 2021-08-26 15:23:28

文章被收录于专栏：腾讯会议专家服务

本次更新点

更新前：X-TC-Registered为可选参数，不传该参数时默认按0处理。

更新后：X-TC-Registered为必填参数，不传该参数会报错。

预计更新时间

2021年9月24日

影响范围

创建会议接口，会议的相关查询/修改/取消等接口

修改方法

所有请求均需将X-TC-Registered作为必填参数传入，创建会议请求除未启用通讯录（腾讯会议后台无任何用户账号）特殊场景传0，其余场景传1。
对会议的查询/修改/取消等操作，需要与创建会议时传入的X-TC-Registered值保持一致。为兼容以前创建的会议，如果用户有记录创建会议时传入的该参数值，则与创建时保持一致即可；如果没有记录，可尝试先传1，报错后再传0重试。

参数说明

X-TC-Registered参数为Rest API接口公共参数，在每个消息的消息头都需要填写该参数，定义如下：

当X-TC-Registered为1时，后台会对传入的创建者userid做校验转换（转换成后台的用户唯一标识）；当X-TC-Registered为0时，后台不会对创建者userid做转换，也就是说此时会议的创建者在后台不是一个真实的用户。要验证这两者之间的差异可以创建一个会议，不传hosts，invitees等参数，然后以创建者账号登录腾讯会议APP，可以发现传1时会议列表能看到刚才创建的会议，而传0时则看不到刚才创建的会议。传0主要用于某些不开启账户通讯录的特殊场景。