接口咨询 020-3886 5521

M3U8解析接口

M3U8解析接口做三件事:读索引、拼切片、带 key。索引按 RFC 8216 解析,切片地址按相对路径还原成绝对地址,AES-128 的 key 请求由服务端代取,前端不用再处理跨域和 referer。

光纤配线架上的尾纤与端口

接口参数

接口版本REST 风格,POST /parse,返回 JSON;协议遵循 RFC 8216
输出格式JSON:切片数组、时长、加密方式、清晰度标记
并发配额标准套餐 200 QPS,扩容套餐 800 QPS,按峰值计
字段覆盖12 项,含 segments、duration、key_uri、bandwidth、codec
兼容性HLS 标准播放器、hls.js 1.x、原生 Safari 播放器
部署方式公网 HTTPS 接口,可选私有化部署到自有服务器
数据合规只做地址解析,不转存切片内容,日志保留 7 天
SLA 响应解析失败率超过 3% 触发告警,30 分钟内响应
切片超时单片 8 秒超时,超时后回明确错误码而不是空数组

参数按 M3U8解析接口 的交付口径写,实际配额以控制台显示为准。

三个实际使用场合

异地播放的跨域问题

切片域名不带跨域头,浏览器直连会被拦。走解析接口后由服务端取流再回给前端,跨域问题在服务端解决,前端只处理一个地址。

加密流的 key 代取

AES-128 加密流的 key 地址带时效签名,前端自己取容易过期。解析接口按请求时间重新签名,过期率从 12% 降到 1% 以内。

清晰度自动降级

同一部片有 1080P 与 720P 两套索引。解析接口按 bandwidth 排序,网络差时先给 720P,播放器切换不用重新拉全量索引。

选型建议

先确认播放串是不是标准 HLS。带 #EXT-X-STREAM-INF 的多码率索引需要解析器支持主列表,只做单码率的小解析器会在多码率流上直接报错。另一个判断点是加密:只有 AES-128 的需要代取 key,SAMPLE-AES 场景要单独评估,不能直接套这一条。

客户为什么选这一条,而不是隔壁那家

三条可验证的差异

  • 错误码分 9 类:索引 404、切片超时、key 403、编码不支持各有独立码,排查不用翻日志。
  • 相对路径自动还原:索引里写 ../seg/1.ts 这种相对路径也能拼成绝对地址,不用前端补。
  • 解析结果带缓存头:同一索引 5 分钟内命中缓存,命中率约 78%,回源压力下降明显。

交付周期与售后条款

阶段时间与内容
测试 key当天开通,含 1000 次试调用
链路联调1 至 2 个工作日,交付调用示例
正式上线第 4 个工作日,可灰度 10% 流量

解析错误按错误码归因,非我方原因(源站 404)不计入 SLA;接口版本升级保留旧版 30 天;不承诺任何片源的可播放性,只保证解析逻辑正确。

这一类里的其他接口

相关现场记录:骨干光缆割接:跨省首帧从3.1秒、核心交换机换新:一台 48 口设。分类与字段口径见播放解析转码,完整字段说明在对接文档。

常被问到的问题

能解析 mp4 直链吗

能,直链按单切片返回,时长字段可能为空。

支持 DRM 吗

不支持 Widevine 等 DRM,只做 HLS 常规加密。

能私有化部署吗

能,容器镜像交付,最低 2 核 4G,需要能访问源站。