FAQ

API对接常见问题

1、Token获取失败

处理方法：

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

2）核对请求地址是否正确，并确保接口请求方的网络可正常访问UC服务器的https端口，正确的格式应是 https://x.x.x.x/open/api/v2/token，其中x.x.x.x使用服务器ip或可解析域名，并注意核对服务器的https监听端口是否已变更，默认443，若有变更成其他端口，则需将x.x.x.x改成x.x.x.x:端口，不支持通过http调用接口；

3）确保UC服务器时间与接口调用服务器之间时差不超过60秒。

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

2、连续调用api接口是，报错{"code":"500403","details":null,"message":"Request replay"}

处理方法：当遇到该错误时，你应该核对接口请求header中的nonce值是否每次都是随机的，若每次均是固定值，便会遇到该报错，请使用随机数；

确保UC服务器时间与接口调用服务器之间时差不超过60秒。

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

处理方法：

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

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

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

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

4、调用“查询企业录制文件下载地址”接口，发现返回的下载地址中的ip是127.0.0.1

处理方法：

1）查看请求参数Headers中，是否有Referer字段

2）Referer字段需填写为http://x.x.x.x的形式，或https://x.x.x.x，其中x.x.x.x填写为服务器IP或可解析域名即可。

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

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

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

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

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

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

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

7、企业管理平台-应用管理，配置事件订阅地址时提示格式不正确

处理方法：请注意，事件订阅URL在UC平台版本从V45 SP1开始支持http，即版本号为45.1.x.x以上，在此版本之前均不支持http，需要配置https协议的地址。

8、调用“添加会议”接口时，报错Management account cannot schedule meetings？

处理方法：请核对对应账号是否存在，已被删除的账号无法预约会议。

9、调用“设置RTSP直播状态”接口时，布局参数和分辨率参数未生效？

处理方法：会议室默认预设了一个RTSP布局模板，名为“默认”，当你需要设置并启用该模板进行直播推流了，请先调用“修改RTSP直播设置”接口，根据要求调整模板中的参数后，再使用“设置RTSP直播状态”接口开启推流，即默认的模板不响应“设置RTSP直播状态”接口中的扩展参数。

tips：当使用index 0创建新直播时，“设置RTSP直播状态”接口中的扩展参数可正常生效，也就是相当于创建一个新模板，模板参数来源为扩展参数。

10、调用API接口，只有"获取token"接口可以调用成功，其他接口均提示：”The resource does not exist or has deleted“.

处理方法：确认是否用系统级管理平台的access key ID/access key secret去调用企业管理员平台的接口，具体可以参考此链接。