修订记录

2025-09-12

第五十五次发布：

本次变更如下：

新增直播水印管理接口组。

2025-08-26

第五十四次发布：

本次变更如下：

下线流管理接口组的接口：查询直播中的流信息。

2025-07-31

第五十三次发布：

本次变更如下：

流管理接口组新增接口：禁推闪断。

2024-07-30

第五十二次发布：

本次变更如下：

• 域名管理接口组新增接口：修改域名HLS配置、查询域名HLS配置。
• 鉴权管理接口组新增接口：设置Referer防盗链黑白名单、删除Referer防盗链黑白名单、查询Referer防盗链黑白名单。
• 数据统计分析接口组新增接口：查询播放域名下的流数据。

2024-02-23

第五十一次发布：

本次变更如下：

修改创建录制规则和修改录制规则接口FLV、MP4格式的“record_cycle” 字段最大值。

2023-09-19

第五十次发布：

本次变更如下：

修改转码模板管理组接口。请求参数新增字段bitrate_adaptive和i_frame_policy，并更新字段templateName、PVC、hdlb、width、height、iFrameInterval、gop的参数说明。

2023-07-24

第四十九次发布：

本次变更如下：

修改查询转码用量接口，增加按小时结算的资源出账描述和请求示例。

修改查询直播各区域指标分布接口，增加查询数据用于对账，查询三个小时之前的描述。

修改创建录制视频索引文件接口，补充接口约束说明和状态码描述，补充“start_time”和“end_time”参数说明。

2023-05-12

第四十八次发布：

本次变更如下：

增加错误码LIVE.100011022。

2023-05-06

第四十七次发布：

本次变更如下：

修改查询播放流量汇总接口描述，增加查询数据会延迟10分钟左右的描述。

2023-04-23

第四十六次发布：

本次变更如下：

修改查询转码用量接口描述，增加转码数据延时1小时的描述。

2023-04-18

第四十五次发布：

本次变更如下：

调整查询直播各区域指标分布接口的用户和API流量限制，用户流量限制由1次/秒变更为50次/秒，API流量限制由5次/秒变更为150次/秒。

2023-03-21

第四十四次发布：

本次变更如下：

• 新增鉴权、截图、HTTPS证书和OBS桶管理接口组。
• 修改创建录制规则和修改录制规则接口的“default_record_config”、“hls_config”和 “record_cycle” 字段的默认值。

2023-02-09

第四十三次发布：

本次变更如下：

修改创建录制规则和修改录制规则接口的“record_prefix”、“record_ts_prefix”参数的描述。

2023-01-18

第四十二次发布：

本次变更如下：

• 创建直播转码模板、创建录制规则接口新增计费说明。
• “使用前必读”章节新增域名管理接口流控限制。

2023-01-06

第四十一次发布：

本次变更如下：

• 新增查询CDN上行推流质量数据接口。
• 修改查询播放带宽趋势、查询播放流量趋势、查询播放带宽峰值和查询播放流量汇总接口的“play_domains”参数为非必填。
• 查询播放带宽趋势、查询播放流量趋势、查询播放带宽峰值、查询播放流量汇总和查询流维度的观众趋势接口新增“service_type”参数。
• 查询上行带宽数据接口新增“type”参数。

2022-12-29

第四十次正式发布：

本次变更如下：

修改地区/国家代码对照表。

2022-12-27

第三十九次正式发布

本次变更如下：

• 新增查询直播各区域指标分布接口。
• 删除上行带宽数据接口“type”参数。
• 创建录制回调配置、修改录制回调配置接口增加成功状态的响应参数、请求参数key。
• 修改配置域名IPV6开关接口的请求示例。
• 修改地区/国家代码对照表。

2022-12-20

第三十八次正式发布

本次变更如下：

查询上行带宽数据接口新增“type”参数。

2022-12-07

第三十七次正式发布

本次变更如下：

• v1接口增加AK/SK鉴权头域。
• 下线查询直播各区域指标分布接口。

2022-11-08

第三十六次正式发布

本次变更如下：

删除查询播放带宽趋势接口中的“service_type”参数。

2022-09-29

第三十五次正式发布

本次变更如下：

删除录制回调管理接口中的“call_back_ssl_ca”和“call_back_ssl_verify”参数。

2022-09-27

第三十四次正式发布

本次变更如下：

修改查询录制规则配置接口的示例代码，删除“start_time”、“project_id”和“end_time”参数。

2022-09-08

第三十三次正式发布：

本次变更如下：

修改地区/国家代码对照表。

2022-09-06

第三十二次正式发布：

本次变更如下：

录制管理接口组新增创建录制视频索引文件接口。

2022-08-26

第三十一次正式发布：

本次变更如下：

• 修改查询直播各区域指标分布接口的“area”字段描述和返回体中的“name”字段描述。
• 修改查询转码用量接口、查询录制用量接口和查询截图用量接口的最大查询周期为1年。
• 新增地区/国家代码对照表。

2022-07-05

第三十次正式发布：

本次变更如下：

• 查询播放带宽趋势接口新增“service_type”参数。
• 所有接口中的响应Header参数“X-request-id”修改为“X-Request-Id”。
• 修改查询直播域名接口的响应示例。

2022-07-01

第二十九次正式发布

本次变更如下：

修改查询播放画像接口的参考示例。

2022-03-25

第二十八次正式发布

本次变更如下：

修改直播转码模板删除成功的状态码为200。

2022-03-01

第二十七次正式发布

本次变更如下：

• 调整查询直播中的流信息接口的用户和API流量限制，用户流量限制由4000次/分钟变更为1000次/分钟，API流量限制由8000次/分钟变更为2000次/分钟。
• 调整禁推恢复接口的用户和API流量限制，用户流量限制由4000次/分钟变更为3000次/分钟，API流量限制由8000次/分钟变更为6000次/分钟。
• 调整查询禁止直播推流列表接口的用户和API流量限制，用户流量限制由300次/分钟变更为3000次/分钟，API流量限制由3000次/分钟变更为6000次/分钟。
• 调整禁止直播推流和修改禁推属性接口的API流量限制，由8000次/分钟变更为12000次/分钟。

2022-02-28

第二十六次正式发布

本次变更如下：

• 删除查询直播转码任务数接口。
• 调整查询播放带宽趋势接口的用户流量限制，由300次/分钟变更为500次/分钟。

2022-02-22

第二十五次正式发布

本次变更如下：

流监控中增加查询流监控数据接口。

2022-01-26

第二十四次正式发布

本次变更如下：

• 修改录制管理接口组，删除“PLAN_RECORD”、“ON_DEMAND_RECORD”相关参数和说明。
• 修改录制回调管理接口组，删除“on_demand_callback_url”相关参数和说明。
• 数据统计分析中增加查询直播转码任务数接口和查询直播各区域指标分布接口。

2021-12-21

第二十三次正式发布

本次变更如下：

修改流管理接口组和转码模板管理接口组中“domain”参数的描述，变更为推流域名。

2021-12-16

第二十二次正式发布

本次变更如下：

• 修改创建录制规则接口的“default_record_config”参数为必填。
• 修改查询录制回调配置列表和查询录制规则列表接口的“offset”、“limit”参数的描述。

2021-11-26

第二十一次正式发布

本次变更如下：

• 查询录制用量接口，增加“publish_domain”参数。
• 查询推流帧率数据接口，增加返回的帧率数据列表粒度为1秒钟的描述。
• 查询推流码率数据接口，增加返回的码率数据列表粒度为1秒钟的描述。
• 查询历史推流列表接口，删除最大查询周期1个月的描述。

2021-10-27

第二十次正式发布

本次变更如下：

查询推流帧率数据和查询推流码率数据接口修改“data_list”参数描述，增加帧率和码率单位。

2021-09-26

第十九次正式发布

本次变更如下：

• 修改查询播放画像信息接口，增加约束描述，不统计协议为HLS的播放时长（play_duration）信息。
• 修改查询转码用量接口，增加“stream”参数。

2021-09-10

第十八次正式发布

本次变更如下：

• 录制管理中增加提交录制控制命令接口。
• 修改查询直播中的流信息接口，增加“video_frame_rate”、“audio_frame_rate”等参数。

2021-08-12

第十七次正式发布

本次变更如下：

• 查询播放带宽趋势接口和查询观众趋势接口增加“country”参数。
• 新增“国家名称缩写”章节内容。

2021-06-02

第十六次正式发布

本次变更如下：

创建录制规则接口修改“record_format”字段的格式，设置格式时必须使用大写字母。

2021-03-05

第十五次正式发布

本次变更如下：

上线录制管理接口组和录制回调管理接口组。

2021-01-28

第十四次正式发布

本次变更如下：

上线域名管理接口组和日志管理接口。

2021-01-19

第十三次正式发布

本次变更如下：

流管理中增加查询直播中的流信息接口。

2020-11-13

第十二次正式发布

本次变更如下：

数据统计分析中增加查询转码用量接口、查询录制用量接口和查询截图用量接口。

2020-09-17

第十一次正式发布

本次变更如下：

禁止直播推流接口修改“resume_time”字段的取值范围，默认值为7天，最大支持90天。

2020-08-25

第十次正式发布

本次变更如下：

数据统计分析中增加查询上行带宽数据接口、查询域名维度推流路数接口和查询历史推流列表接口。

2020-08-12

第九次正式发布

本次变更如下：

数据统计分析中增加查询直播拉流HTTP状态码接口。

2020-08-05

第八次正式发布

本次变更如下：

上线数据统计分析接口组和流监控接口组。

2020-07-30

第七次正式发布

本次变更如下：

增两个API应用示例，示例2：创建录制配置和示例3：禁止直播推流。

2020-05-20

第六次正式发布

本次变更如下：

所有接口增加“调试”内容，支持跳转到API Explorer进行接口调试。

2020-04-10

第五次正式发布

本次变更如下：

下线“查询直播推流列表”接口，后续将上线相关新接口。

2019-11-14

第四次正式发布

本次变更如下：

上线新版“查询直播推流列表”接口。

2019-07-27

第三次正式发布

本次变更如下：

修改转码模板管理接口，增加“iFrameInterval”、“GOP”等参数。

2019-06-27

第二次正式发布

本次变更如下：

• 增加应用示例章节，以具体接口为例，介绍如何调用直播API。
• 修改API参考文档，增加使用前必读和如何调用API章节。

2018-11-20

第一次正式商用发布。