私有M3U8(pm3u8)
pm3u8
接口只能用于私有空间中的 m3u8 文件,作用是对 m3u8文件中的 ts 资源进行批量下载授权。通过将 ts 资源的 url 改写成私有 url,以临时获取访问权限。
[GET]pm3u8/<Mode>
/expires/<Expires>
/deadline/<Deadline>
参数名称 | 必填 | 说明 |
---|---|---|
/<Mode> |
是 | 处理模式,只有一个值0。 0表示对所有ts资源的url进行下载授权。 |
/expires/<Expires> |
私有ts资源url下载凭证的相对有效期,单位秒。 推荐43200秒(12小时)。 |
|
/deadline/<Deadline> |
私有ts资源url下载凭证的绝对有效期(Unix Time),单位秒。 此参数填写后,expires失效。 |
请求语法
GET <M3U8DownloadURI>?<接口规格> HTTP/1.1
Host: <M3U8DownloadHost>
响应语法
HTTP/1.1 200 OK
Content-Type: application/x-mpegURL
<M3U8TextData>
响应状态码
HTTP状态码 | 含义 |
---|---|
200 | 授权成功 |
400 | 请求报文格式错误 |
404 | 资源不存在 |
599 | 服务端操作失败。 如遇此错误,请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。 |
响应内容
- 如果请求成功,返回新的、包含已颁发下载授权凭证的各个ts资源访问URL的m3u8文件:
...过多内容已省略...
#EXTINF:61.120000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000000.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:ejpJ9vAKYYK1ZSpW6z3uS2pGBlo
#EXTINF:59.360000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000001.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:Ufr6wcVrUmY7jr8IpRH2fkCo2G0
...过多内容已省略...
- 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
{
"code": <HttpCode int>,
"error": "<ErrMsg string>",
}
字段名称 | 必填 | 说明 |
---|---|---|
code | 是 | HTTP状态码,请参考响应状态。 |
error | 是 | 与HTTP状态码对应的消息文本 |
示例
原始m3u8链接与内容如下所示:
http://7xoucz.com1.z0.glb.clouddn.com/qiniutest.m3u8?e=1449116672&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:JCrhZN1XbkSeNBucKRzmx3R-kzY=
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-ALLOW-CACHE:YES
#EXT-X-TARGETDURATION:62
#EXTINF:61.120000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000000.ts
#EXTINF:59.360000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000001.ts
#EXTINF:59.640000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000002.ts
#EXTINF:2.480000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000003.ts
#EXT-X-ENDLIST
对m3u8资源进行私有资源下载授权时指定pm3u8
接口,可以获取到相应的批量授权下载URL:
http://7xoucz.com1.z0.glb.clouddn.com/qiniutest.m3u8?pm3u8/0&e=1449126571&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:SGhJE2aC685_YmHMOtJEngduFes=
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-ALLOW-CACHE:YES
#EXT-X-TARGETDURATION:62
#EXTINF:61.120000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000000.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:ejpJ9vAKYYK1ZSpW6z3uS2pGBlo
#EXTINF:59.360000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000001.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:Ufr6wcVrUmY7jr8IpRH2fkCo2G0
#EXTINF:59.640000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000002.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:SfGPTw3-5MGJQk1xN6dECELKjwQ
#EXTINF:2.480000,
http://7xoucz.com1.z0.glb.clouddn.com/7ZZYqVpgENDWOEdpmCR3Eg9Rdig=/lhsawSRA9-0L8b0s-cXmojaMhGqn/000003.ts?e=1449166183&token=GeKdDZhpPh6rxoVNCSrvygimGSdH7jOUvalFGZrp:vriMgesiM95izCCRUrfAMT3bdVs
#EXT-X-ENDLIST
注意:ts资源的原始下载URL必须以http://
打头。
文档反馈
(如有产品使用问题,请提交工单)