PlayM3u8

PlayM3u8 云平台开放 API 文档

功能概括

我们提供 PlayM3u8 云平台的 API ,功能包括:资源信息、真实地址解析等。

API接口地址

http://www.xxxxx.xom/api

GET请求参数列表

名称 类型 可选值 默认值 描述
type * string 仅当使用 type + vid 模式时需传递,指明视频网站。请参考下面支持视频网站解析列表
vid * string 此参数指定视频 vid
url * string 使用 url 模式时需传递,指视频网站链接。 例如 a站 http://www.acfun.tv/v/ac2546220
hd int 1、2、3 2 设置清晰度。所有可能取值和其含义为 1: 标清2: 高清3: 超清。如果没有这个清晰度的结果,则会返回最接近它的结果(向下优先)。
mode string pc、iphone 自动 设置播放模式,值为 iphone 时只返回供 HTML5 播放的单段的视频(包括 MP4M3U8),值为 pc 时返回供 Flash 或客户端播放的分段视频,不传递此参数则会选择最佳方案,请根据您的客户端是否支持分段视频来确定此参数。
apikey * string 必须传递。联系客户 获取apikey

API使用方式

API 以 GET方式请求地址 + 参数 的形式被调用。

url模式: http://{接口地址}/api?apikey={你的apikey}&url={资源url}

vid模式: http://{接口地址}/api?apikey={你的apikey}&type={资源type}&vid={资源vid}

通用输出

所有的 API 调用过程,都会输出下面这些参数。

名称 类型 成功时输出 描述
code int 200 表明输出的代码,一般 200 表示成功。
message string 成功消息 如果失败请查看此参数的输出内容。
result array 查询结果 你想要的结果。
ctime int 过期时间 以秒为单位返回缓存的剩余的过期时间。
cost float 查询用时 此次请求 API 所用的时间,单位为秒。

返回PC端分段 JSON结果

{
  "code": 200,
  "source": "xxxx",
  "request_url": "http://x.xxxxx.xxx/v_show/id_xxxxxxxxxxx==.html",
  "message": "操作正常",
  "result": {
    "filelist": [
      {
        "url": "http://x.xxxxx.xxx/player/getFlvPath/sid/0488084355948128bbf0b_00/st/flv/fileid/0300011B0056EBF21C27B205CF07DD105EA202-7601-89B9-ED61-928F43408298?K=b211a17c6d9c568b2412ec06&sign=b94744a54089c1e81fc3d6913b9f635a&ctype=12&hd=2&myp=0&ts=197.28&ypp=0&ep=ciacEkmFUs0F4CrbgD8bb36wInddXP4J9h%2BFgNMQALshTp3N7zzQtJ%2B3PP1CE4pvciVyZOrxrqWWaEAWYfdFqWkQ10faMPqVivbi5aRRzOYEZR02es%2FevFSeRjT1&ev=1&token=0544&oip=1779378361",
        "size": "38340249",
        "seconds": 197.28
      },
      {
        "url": "http://x.xxxxx.xxx/player/getFlvPath/sid/0488084355948128bbf0b_00/st/flv/fileid/0300011B0156EBF21C27B205CF07DD105EA202-7601-89B9-ED61-928F43408298?K=1815072515dc9e9e282c26b9&sign=7e372e2c933afccc2de3ff4a13fd510d&ctype=12&hd=2&myp=0&ts=186.08&ypp=0&ep=ciacEkmFUs0F4CrbgD8bb36wInddXP4J9h%2BFgNMQALohTp3N7zzQtJ%2B3PP1CE4pvciVyZOrxrqWWaEAWYfdFqWkQ10faMPqVivbi5aRRzOYEZR02es%2FevFSeRjT1&ev=1&token=0544&oip=1779378361",
        "size": "35627250",
        "seconds": 186.08
      },
      {
        "url": "http://x.xxxxx.xxx/player/getFlvPath/sid/0488084355948128bbf0b_00/st/flv/fileid/0300011B0256EBF21C27B205CF07DD105EA202-7601-89B9-ED61-928F43408298?K=7a4513fb17c658be282c26b9&sign=3dde3b3d4c67d6d59f3b38b8d8940a35&ctype=12&hd=2&myp=0&ts=195&ypp=0&ep=ciacEkmFUs0F4CrbgD8bb36wInddXP4J9h%2BFgNMQALkhTp3N7zzQtJ%2B3PP1CE4pvciVyZOrxrqWWaEAWYfdFqWkQ10faMPqVivbi5aRRzOYEZR02es%2FevFSeRjT1&ev=1&token=0544&oip=1779378361",
        "size": "40613737",
        "seconds": 195
      },
      {
        "url": "http://x.xxxxx.xxx/player/getFlvPath/sid/0488084355948128bbf0b_00/st/flv/fileid/0300011B0356EBF21C27B205CF07DD105EA202-7601-89B9-ED61-928F43408298?K=33840410b2320c33261f895f&sign=f4c49f9e74df7d84ee1e3c87a671cb6d&ctype=12&hd=2&myp=0&ts=186.88&ypp=0&ep=ciacEkmFUs0F4CrbgD8bb36wInddXP4J9h%2BFgNMQALghTp3N7zzQtJ%2B3PP1CE4pvciVyZOrxrqWWaEAWYfdFqWkQ10faMPqVivbi5aRRzOYEZR02es%2FevFSeRjT1&ev=1&token=0544&oip=1779378361",
        "size": "39362648",
        "seconds": 186.88
      },
      {
        "url": "http://x.xxxxx.xxx/player/getFlvPath/sid/0488084355948128bbf0b_00/st/flv/fileid/0300011B0456EBF21C27B205CF07DD105EA202-7601-89B9-ED61-928F43408298?K=47e0a99d4cd796c52412ec06&sign=e920b475f35876eb2ade4572207355ac&ctype=12&hd=2&myp=0&ts=180.6&ypp=0&ep=ciacEkmFUs0F4CrbgD8bb36wInddXP4J9h%2BFgNMQAL8hTp3N7zzQtJ%2B3PP1CE4pvciVyZOrxrqWWaEAWYfdFqWkQ10faMPqVivbi5aRRzOYEZR02es%2FevFSeRjT1&ev=1&token=0544&oip=1779378361",
        "size": "39692285",
        "seconds": 180.6
      },
      {
        "url": "http://x.xxxxx.xxx/player/getFlvPath/sid/0488084355948128bbf0b_00/st/flv/fileid/0300011B0556EBF21C27B205CF07DD105EA202-7601-89B9-ED61-928F43408298?K=fbcfdf4273559e8a282c26b9&sign=e71a62a5208108767d2b68cef4d6163b&ctype=12&hd=2&myp=0&ts=192.68&ypp=0&ep=ciacEkmFUs0F4CrbgD8bb36wInddXP4J9h%2BFgNMQAL4hTp3N7zzQtJ%2B3PP1CE4pvciVyZOrxrqWWaEAWYfdFqWkQ10faMPqVivbi5aRRzOYEZR02es%2FevFSeRjT1&ev=1&token=0544&oip=1779378361",
        "size": "39677580",
        "seconds": 192.68
      }
    ],
    "play_type": "flv",
    "definition": 2,
    "definitionList": "1标清|2高清|3超清"
  },
  "ctime": 3344,
  "cost": 0.052
}

返回移动端单段 JSON结果

{
  "code": 200,
  "source": "xxxx",
  "request_url": "http://x.xxxxx.xxx/v_show/id_xxxxxxxxxxx==.html",
  "message": "操作正常",
  "result": {
    "files": "http://x.xxxxx.xxx/playlist/m3u8?vid=XMTUwNDA4ODY2NA==&type=hd2&ts=1488082346&keyframe=1&did=d02f74fde6456357b9916001f248f67a&ep=Z3%2fmcWUTbv71dVTCsOR3OKfs2cOt9IzVHOCdkrinSGJGhMSfseYlvuYfqZ%2bYIjHE&sid=0488082346292203d977c&token=2770&ctype=20&ev=1&oip=2340540998",
    "play_type": "m3u8",
    "definition": 2,
    "definitionList": "1标清|2高清|3超清"
  },
  "ctime": 3538,
  "cost": 0.048
}

返回结果字段说明

名称 类型 描述
code int 表明请求结果,200 表示成功,403 404 表示由于视频的原因或者视频网站更新的原因导致的失败,500 表示服务器内部出错,具体错误原因请看 message 字段。
message string 表示成功消息或者失败的原因。
source string 表示视频来源,如 magnetyouku 等。
request_vid string 视频在视频网站的 ID。
request_url string 视频网站的播放URL地址。
result object 视频解析结果,其具体字段解释见下附表。

返回结果中 result 字段说明

返回的 result 字段说明如下:

名称 类型 描述
files string 单段URL地址,如手机端播放的。说明见下方 filelist 字段说明。
filelist array 对象数组,视频真实地址和分段列表。说明见下方 filelist 字段说明。
play_type string 表示当前返回的视频类型,一般可以是 flvmp4m3u8 等。
definition int 返回的结果的清晰度,所有可能取值和其含义为 1: 标清2: 高清3: 超清
definitionList string 这个视频在当前模式下支持的清晰度列表,以“|”分隔,已排好序。

返回结果中 filelist 字段说明

filelist 是一个表示地址列表的数组,其中每个地址 object 的字段说明如下:

名称 类型 描述
url string 单段URL地址,如手机端播放的
ext string 原视频文件格式
size string 文件大小
name string 文件名称

PlayM3u8插件 V17.03.13

  看不清点击更新  

温馨提示:播放插件要求PHP版本在5.4或以上,更新播放器后需清除浏览器和CDN缓存。

升级方式:删除旧版本播放器文件,再上传新版本播放器修改config.php文件配置即可。

下载完成后直接上传{playm3u8目录}到自己的服务器网站根目录下即可,无需任何配置,已经为您配置好了。

使用请求方式

API 以 GET方式请求地址 + 参数 的形式被调用,如:

因为PlayM3u8插件是下载放到自己的服务器上的,所以这里的域名就要是你们自己的。

url模式: http://{你的域名}/playm3u8/?url={资源url}

vid模式: http://{你的域名}/playm3u8/?type={资源type}&vid={资源vid}

iframe标签[VID类型] 如果域名是ssl就把http改为https

<iframe src="http://{你的域名}/playm3u8/?type={资源type}&vid={资源vid}" width="100%" scrolling="no" height="100%" align="middle" frameborder="no" hspace="0" vspace="0" marginheight="0" marginwidth="0" name="tv"></iframe>

iframe标签[URL类型] 如果域名是ssl就把http改为https

<iframe src="http://{你的域名}/playm3u8/?url={资源url}" width="100%" scrolling="no" height="100%" align="middle" frameborder="no" hspace="0" vspace="0" marginheight="0" marginwidth="0" name="tv"></iframe>

PlayM3u8插件请求参数说明

名称 类型 可选值 默认值 描述
type * string 仅当使用 type + vid 模式时需传递,指明视频网站。请参考下面支持视频网站解析列表
vid * string 此参数指定视频 vid
url * string 使用 url 模式时需传递,指视频网站链接。 例如 a站 http://www.acfun.tv/v/ac2546220
hd int 1、2、3 2 设置清晰度。所有可能取值和其含义为 1: 标清2: 高清3: 超清。如果没有这个清晰度的结果,则会返回最接近它的结果(向下优先)。
play_title string 云解析平台-正在播放 播放器播放标题
width string 100% 设置播放器宽度(不加保持默认)
height string 100% 设置播放器高度(不加保持默认)

各大CMS程序整合教程,下面是支持整合教程列表,仅供参考。

Discuz论坛        Wordpress        苹果CMS 8X        海洋CMS 6.+        飞飞 CMS        织梦 CMS        帝国 CMS       

表格内仅测试结果,实际情况略有出入。

支持网站 type 支持GET方式 支持环境 官网地址
优酷视频 youku vidurl pcandroidios http://www.youku.com
优酷云(58值)https youku_ac vid pcandroidios http://www.youku.com
乐视云计算 mmsid vid pcandroidios http://www.le.com
A站视频https acfun vidurl pcandroidios http://www.acfun.tv
B站视频 bilibili vidurl pcandroidios http://www.bilibili.com
音悦台视频 yinyuetai vidurl pcandroidios http://www.yinyuetai.com
爱奇艺视频 iqiyi vidurl pcandroidios http://www.iqiyi.com
56视频 w56 vidurl pcandroidios http://www.56.com
乐视视频 le vidurl pcandroidios http://www.le.com
乐视云计算 lecloud vid pcandroidios http://www.lecloud.com
芒果视频 mgtv vidurl pcandroidios http://www.mgtv.com
微录视频 vlook vidurl pcandroidios http://www.vlook.cn
搜狐视频 sohu vidurl pcandroidios http://tv.sohu.com
腾讯视频 qq vidurl pcandroidios http://v.qq.com
土豆(云)视频 tudou vidurl pcandroidios http://www.tudou.com
酷6视频 ku6 vidurl pcandroidios http://v.ku6.com
秒拍视频 miaopai vidurl pcandroidios http://www.miaopai.com
微博视频 weibo vidurl pcandroidios http://weibo.com
PPTV云 pptvyun vidurl pcandroidios http://www.pptvyun.com
PPTV视频 pptv vidurl pcandroidios http://v.pptv.com
17173视频 v17173 vidurl pcandroidios http://v.17173.com/
1905电影 m1905 vidurl pcandroidios http://www.1905.com
凤凰视频 ifeng vidurl pcandroidios http://v.ifeng.com
美拍视频 meipai vidurl pcandroidios http://www.meipai.com
CNTV央视 cntv vidurl pcandroidios http://tv.cctv.com
M3U8|MP4直连 playm3u8 url pcandroidios 无地址
虎牙视频 huya vidurl pcandroidios http://v.huya.com
在线交谈:  点击这里给我发消息