搜本产品 
直播API概述
直播加速服务（Live-Video）基于京东云大规模云计算基础资源，为客户提供低延迟、高可用、易接入的视频直播一站式服务，帮助客户快速搭建自己的直播平台及应用。客户开通京东云直播加速服务后，可以使用京东云提供的直播Open API，更方便、更细维度的管理自己的直播业务。
当前直播Open API的版本号为：1.0.17
##术语表：
| 接口名称 | 功能描述 |
|---|---|
| addCustomLiveStreamRecordTemplate | 添加用户自定义直播录制模板 |
| addCustomLiveStreamSnapshotTemplate | 添加直播截图模板 |
| addCustomLiveStreamTranscodeTemplate | 添加自定义转码模板 - 系统为您预设了标准转码模板,如果不能满足您的转码需求,可以通过此接口添加自定义转码模板 - 系统标准转码模板 ld (h.264/640360/15f) sd (h.264/960540/25f) hd (h.264/1280720/25f) shd (h.264/19201080/30f) ld-265 (h.265/640360/15f) sd-265 (h.265/960540/25f) hd-265 (h.265/1280720/25f) shd-265 (h.265/19201080/30f) |
| addCustomLiveStreamWatermarkTemplate | 添加用户自定义水印模板 |
| addLiveApp | 添加直播应用名 - 需要提前在应用(app)级别绑定功能模板时才需要提前新建应用名 - 新的应用名可以推流时自动创建 |
| addLiveDomain | 添加直播域名 - 创建直播域名之前,必须先开通直播服务 - 直播域名必须已经备案完成 |
| addLiveRecordTask | 添加打点录制任务 - 您可以调用此接口精确提取已录制的文件中所需要的部分 |
| addLiveRestartDomain | 添加回看域名 |
| addLiveStreamAppRecord | 添加应用级别直播录制配置 - 添加应用级别的直播录制模板配置 |
| addLiveStreamAppSnapshot | 添加应用截图配置 - 添加应用级别的截图模板配置 |
| addLiveStreamAppTranscode | 添加应用转码配置 - 添加应用级别的转码模板配置 |
| addLiveStreamAppWatermark | 添加应用级别水印配置 |
| addLiveStreamDomainRecord | 添加域名级别直播录制配置 - 添加域名级别的直播录制模板配置 |
| addLiveStreamDomainSnapshot | 添加域名截图配置 - 添加域名级别的截图模板配置 |
| addLiveStreamDomainTranscode | 添加域名级别转码配置 - 添加域名级别的转码模板配置 |
| addLiveStreamDomainWatermark | 添加域名水印配置 |
| addLiveStreamRecord | 添加流的录制模板配置 |
| checkDomainIcp | 校验域名是否备案 |
| closeLiveRestart | 关闭回看 |
| closeLiveTimeshift | 关闭时移 |
| deleteCustomLiveStreamRecordTemplate | 删除用户自定义录制模板 - 删除用户自定义录制模板之前必须先删除此模板在各域名、应用、流级别的录制设置 |
| deleteCustomLiveStreamSnapshotTemplate | 删除用户自定义直播截图模板 - 删除截图模板前,请先删除此模板相关的截图配置,否则将会影响线上业务 |
| deleteCustomLiveStreamTranscodeTemplate | 删除用户自定义转码模板 - 删除用户自定义转码模板之前必须先删除此模板在各域名、应用、流级别的转码设置 |
| deleteCustomLiveStreamWatermarkTemplate | 删除用户自定义水印模板 - 删除用户自定义水印模板之前必须先删除此模板在各域名、应用、流级别的水印设置 |
| deleteLiveDomain | 删除直播域名 - 请慎重操作（建议在进行域名删除前到域名解析服务商处恢复域名A记录），以免导致删除操作后此域名不可访问。 deleteLiveDomain调用成功后将删除本条直播域名的全部相关记录，对于仅需要暂停使用该直播域名，推荐stopLiveDomain接口 |
| deleteLiveRecordFiles | 删除录制文件 |
| deleteLiveSnapshots | 删除截图 |
| deleteLiveStreamAppRecord | 删除应用级别录制模板配置 - 删除应用级别的录制模板配置,重新推流后生效 |
| deleteLiveStreamAppSnapshot | 删除APP截图配置 |
| deleteLiveStreamAppTranscode | 删除应用级别转码模板配置 - 删除应用级别的转码模板配置,重新推流后生效 |
| deleteLiveStreamAppWatermark | 删除应用级别水印模板配置 - 删除应用级别的水印模板配置,重新推流后生效 |
| deleteLiveStreamDomainRecord | 删除域名级别录制模板配置 - 删除域名级别录制模板配置,重新推流后生效 |
| deleteLiveStreamDomainSnapshot | 删除域名截图配置 - 删除域名级别的截图模板配置,重新推流后生效 |
| deleteLiveStreamDomainTranscode | 删除域名级别转码模板配置 - 删除域名级别转码模板配置,重新推流后生效 |
| deleteLiveStreamDomainWatermark | 删除域名级别水印模板配置 - 删除域名级别水印模板配置,重新推流后生效 |
| deleteLiveStreamNotifyConfig | 删除直播流状态回调地址 |
| deleteLiveStreamRecord | 删除流级别录制模板配置 - 删除流级别录制模板配置,重新推流后生效 |
| deleteLiveStreamRecordNotifyConfig | 删除录制回调配置 |
| deleteLiveStreamSnapshot | 删除流级别截图模板配置 - 删除流级别截图模板配置,重新推流后生效 |
| deleteLiveStreamSnapshotNotifyConfig | 删除截图回调配置 |
| deleteLiveStreamTranscode | 删除流级别转码模板配置 - 删除流级别转码模板配置,重新推流后生效 |
| deleteLiveStreamWatermark | 删除流级别水印模板配置 - 删除流级别水印模板配置,重新推流后生效 |
| describeCustomLiveStreamRecordConfig | 查询直播直播录制配置 - 录制模板配置按照 域名,应用,流 3级配置添加,以最小的粒度配置生效 - 域名、应用、流 依次粒度递减 即: 域名>应用>流 - 该查询旨在查询域名、应用、流最终生效的录制模板配置,并非各级的模板绑定情况 |
| describeCustomLiveStreamRecordTemplates | 查询用户自定义直播录制模板列表 |
| describeCustomLiveStreamSnapshotConfig | 查询直播截图配置 - 截图模板配置按照 域名,应用,流 3级配置添加,以最小的粒度配置生效 - 域名、应用、流 依次粒度递减 即: 域名>应用>流 - 该查询旨在查询域名、应用、流最终生效的截图模板配置,并非各级的模板绑定情况 |
| describeCustomLiveStreamSnapshotTemplates | 查询直播截图模板列表 |
| describeCustomLiveStreamTranscodeTemplate | 查询用户自定义转码模板详情 - 查询用户自定义转码模板详情 - 系统标准转码模板 ld (h.264/640360/15f) sd (h.264/960540/24f) hd (h.264/1280720/25f) shd (h.264/19201080/30f) ld-265 (h.265/640360/15f) sd-265 (h.265/960540/24f) hd-265 (h.265/1280720/25f) shd-265 (h.265/19201080/30f) |
| describeCustomLiveStreamTranscodeTemplates | 查询用户自定义转码模板列表 |
| describeCustomLiveStreamWatermarkConfig | 查询直播水印配置 - 水印模板配置按照 域名,应用,流 3级配置添加,以最小的粒度配置生效 - 域名、应用、流 依次粒度递减 即: 域名>应用>流 - 该查询旨在查询域名、应用、流最终生效的水印模板配置,并非各级的模板绑定情况 |
| describeCustomLiveStreamWatermarkTemplates | 查询用户定义水印模板列表 |
| describeDomainOnlineStream | 查询在线流列表 |
| describeDomainsLog | 日志下载 |
| describeLiveApp | 查询域名下的APP列表 |
| describeLiveDomainDetail | 查询指定域名相关信息 |
| describeLiveDomainRecordConfig | 查询域名下的录制模板配置 |
| describeLiveDomainSnapshotConfig | 查询域名下的截图模板配置 |
| describeLiveDomainTranscodeConfig | 查询域名下的转码模板配置 |
| describeLiveDomainWatermarkConfig | 查询域名下的水印模板配置 |
| describeLiveDomains | 查询域名列表 |
| describeLiveFileStorageData | 查询存储空间数据 |
| describeLivePlayAuthKey | 查询播放鉴权KEY |
| describeLivePornData | 查询直播鉴黄张数数据 |
| describeLivePublishStreamNum | 查询直播推流数 |
| describeLiveRecordData | 查询直播录制时长数据 |
| describeLiveRecordFileUrl | 获取录制文件地址 |
| describeLiveRecordFiles | 查询录制文件列表 |
| describeLiveRestartConfigs | 查询回看配置 |
| describeLiveServiceStatus | 查询服务开通状态 |
| describeLiveSnapshotData | 查询直播截图张数数据 |
| describeLiveSnapshotUrl | 获取截图地址 |
| describeLiveSnapshots | 查询截图列表 |
| describeLiveStatisticGroupByArea | 查询地域分组统计数据 |
| describeLiveStatisticGroupByAreaIsp | 查询地域/运营商分组统计数据 |
| describeLiveStatisticGroupByStream | 查询流分组统计数据 |
| describeLiveStreamBandwidthData | 查询带宽数据 - 查询某个时间段内的带宽数据（平均带宽） - 查询1分钟粒度的数据时，时间跨度不超过7天，其他粒度时时间跨度不超过30天 |
| describeLiveStreamHistoryUserNum | 查询直播流历史在线人数 |
| describeLiveStreamInfo | 查询直播实时流信息 |
| describeLiveStreamList | 查询直播流信息 |
| describeLiveStreamNotifyConfig | 查询直播流状态回调地址 |
| describeLiveStreamOnlineList | 查询直播中的流的信息 |
| describeLiveStreamPlayerRankingData | 查询直播流播放人数排行 |
| describeLiveStreamPublishBandwidthData | 查询推流带宽 - 查询某个时间段内的推流上行带宽数据 - 查询1分钟粒度的数据时，时间跨度不超过7天，其他粒度时时间跨度不超过30天 |
| describeLiveStreamPublishList | 查看推流历史记录 |
| describeLiveStreamPublishTrafficData | 查询推流上行流量数据 - 查询某个时间段内的流量数据。 - 查询1分钟粒度的数据时，时间跨度不超过7天，其他粒度时时间跨度不超过30天 |
| describeLiveStreamRecordNotifyConfig | 查询录制回调配置 |
| describeLiveStreamSnapshotNotifyConfig | 查询截图回调配置 |
| describeLiveStreamTrafficData | 查询流量数据 - 查询某个时间段内的流量数据。 - 查询1分钟粒度的数据时，时间跨度不超过7天，其他粒度时时间跨度不超过30天 |
| describeLiveStreamTranscodeConfig | 查询转码模板配置 - 转码模板配置按照 域名,应用,流 3级配置添加,以最小的粒度配置生效原则 - 域名、应用、流 依次粒度递减 即: 域名>应用>流 - 该查询旨在查询域名、应用、流最终生效的转码模板配置,并非各级的模板绑定情况 |
| describeLiveTimeshiftConfigs | 查询时移配置 |
| describeLiveTranscodeStreamBandwidth | 查询转码流播放带宽 - 查询1分钟粒度的数据时，时间跨度不超过7天，其他粒度时时间跨度不超过30天 |
| describeLiveTranscodeStreamList | 查询转码流信息 |
| describeLiveTranscodeStreamNum | 查询转码流数量 |
| describeLiveTranscodeStreamPlayerUserNum | 查询转码流观看人数 |
| describeLiveTranscodingDurationData | 查询转码时长数据 |
| describePlayAuthConfig | 查询播放鉴权配置 |
| describePublishAuthConfig | 查询推流鉴权配置 |
| describePublishStreamInfoData | 查询推流监控数据 |
| describeRecordBinding | 查询录制模板绑定 |
| describeSnapshotBinding | 查询截图模板绑定 |
| describeSystemLiveStreamTranscodeTemplates | 查询系统默认转码模板列表 |
| describeTranscodeBinding | 查询转码模板绑定 |
| describeUrlRanking | 查询URL播放排行 |
| describeWatermarkBinding | 查询水印模板绑定 |
| exportLiveSnapshotData | 导出直播截图张数数据 |
| exportLiveStreamBandwidthData | 导出带宽数据 - 查询某个时间段内的带宽数据（平均带宽） - 查询1分钟粒度的数据时，时间跨度不超过7天，其他粒度时时间跨度不超过30天 |
| exportLiveStreamTrafficData | 导出流量数据 - 查询某个时间段内的流量数据。 - 查询1分钟粒度的数据时，时间跨度不超过7天，其他粒度时时间跨度不超过30天 |
| exportLiveTranscodingDurationData | 导出转码时长数据 |
| exportPublishStreamInfoData | 导出推流监控数据 |
| forbidLiveStream | 禁止直播流推送 |
| interruptLiveStream | 中断直播流推送 - 中断操作1秒后可以继续推流 |
| openLiveRestart | 开启回看 1、直播回看文件格式仅支持m3u8。 2、回看时长用户可以配置，最大支持7天，即用户请求回看内容，最多可以请求最近7天的直播回看内容。 3、域名格式：http://{restartDomain}/{appName}/{streamName}/index.m3u8?starttime=1527756680&endtime=1527760280 (unix时间戳) 4、starttime-endtime最长可支持24小时，可跨天 |
| openLiveService | 开通直播服务 |
| openLiveTimeshift | 开启时移 直播支持最大4小时的HLS时移，使用方式为在播放域名后增加时移参数来实现，参数类型支持指定开始时间和时间偏移量2种方式进行时移。 开启直播时移后，重新推流生效，使用播放域名带相应参数访问即可播放 - 域名格式： 1、http://{playDomain}/{appName}/{streamName}/index.m3u8?timeshift=400（秒，指从当前时间往前时移的偏移量） 2、http://{playDomain}/{appName}/{streamName}/index.m3u8?starttime=1529223702 (unix时间戳) |
| resumeLiveStream | 恢复直播流推送 |
| setLivePlayAuthKey | 设置播放鉴权KEY |
| setLiveStreamNotifyConfig | 设置直播流状态回调地址 |
| setLiveStreamRecordNotifyConfig | 设置直播录制回调通知 |
| setLiveStreamSnapshotNotifyConfig | 设置直播截图回调通知地址 |
| setPlayAuthConfig | 设置播放鉴权KEY |
| setPlayAuthIPConfig | 设置播放鉴权IP黑名单 |
| setPlayAuthRefererConfig | 设置播放鉴权referer |
| setPublishAuthConfig | 设置推流鉴权KEY |
| setPublishAuthIPConfig | 设置推流鉴权IP黑名单 |
| startLiveApp | 启用应用 - 启用 停用 状态的应用 |
| startLiveDomain | 启动域名 - 启用状态为 停用 的直播域名对(推流域名,播放域名)将DomainStatus变更为online |
| stopLiveApp | 停用 运行中 状态的应用 - 停用应用之后,不能再用此应用名推流 |
| stopLiveDomain | 停用域名 - 停用直播域名对(推流域名,播放域名),将DomainStatus变更为offline - 停用该直播域名对后,直播域名信息仍保留,但用户将不能再用该推流域名推流或播放域名播放 |
| updateCustomLiveStreamRecordTemplate | 修改用户自定义直播录制模板 |
| updateCustomLiveStreamSnapshotTemplate | 修改直播截图模板 |
| updateCustomLiveStreamTranscodeTemplate | 修改自定义转码模板 |
| updateCustomLiveStreamWatermarkTemplate | 修改用户自定义水印模板 |
更新时间：2020-10-21 11:16:38
文档反馈
