API对接常见问题

1、Token获取失败

处理方法：

1）需确保调用接口的PC电脑能正常访问YMS网页管理后台，并核对AccessKey ID和AccessKey Secret 是否无误；

2）核对请求地址是否正确，正确的格式应是 https://api.ylyun.com/open/api/v2/token

3）确保接口调用发起方的PC或是服务器，和互联网时间之间需无时差。

4）对照postman用例模板中的获取Token用例，查看Headers、Authorization、body，与自己的代码是否一致。

2、调用“查询用户列表”接口，返回的数据不完整

处理方法：

1）确认用户数是否超过100，以及请求参数中的limit 字段值（用于设置一次返回的用户数，最大100）

2）由于接口最多一次返回100个记录数，因此若用户数超过100，且limit也已设置100，则返回的用户数

仅会是100，属于正常返回。若有账号同步需求，建议使用接口“查询用户树”。

3）若用户数不超过100，且也小于limit字段值，返回的记录数仍与实际不一致，则反馈亿联技术支持。

3、“添加会议”接口，预约成功后，邮件通知参会成员会议日程时，日程内容语言是英文而非中文？

原因：api接口的headers参数缺失language导致

处理方法：添加language，值设为zh即可。

4、调用会议控制中针对单个参会成员的操作接口时（如禁言/解除禁言/关闭视频/请求打开视频/踢人等），未调用成功？

原因：需注意请求参数中的userId值，并非是通过“查询用户列表”接口或者“查询用户树”接口获得的用户信息中的id，而是通过“7.4 查询会议用户信息”接口获得的userId。

处理方法：当调用会议控制中涉及对单个参会成员的操作接口时，接口请求参数中的userId值需参照接口文档中的请求消息示例，为纯数字时，则该userId获取途径应通过“7.4 查询会议用户信息”接口获取。

如下图，以调用“禁言”接口为例：