文档首页

新手指南

API参考手册

SDK

工具

技术文章

私有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下载凭证的绝对有效期，单位秒。
此参数填写后，expires失效。

请求

请求报文格式

GET <M3U8DownloadURI>?<接口规格> HTTP/1.1
Host: <M3U8DownloadHost>

注意：这里的m3u8文件存在于私有空间，M3U8DownloadURI的生成方法请参考七牛的下载凭证。

响应

响应报文格式

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://打头。

如果有任何问题，请进入 七牛云存储问答社区 或者发送 工单 咨询