智能多媒体 API

  • 私有M3U8

    最近更新时间:2018-04-13 16:14:36

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

    以上内容是否对您有帮助?
  • Icon free helper
    Close