保利威文档中心

幫助中心

取得單一影片資訊

更新時間：2023-11-14 14:07:19

介面描述

1、获取用户单条视频记录
2、接口支持https协议

接口URL

http://api.polyv.net/v2/video/{userid}/get-video-msg

請求方式

POST, GET

介面說明

支援格式

XML/JSON

請求數限制

TRUE

請求參數

參數名稱 必填 類型及範圍 說明
vid true string 影片ID
userid true string 使用者ID（在URL中使用，請求時不需要提交）
ptime true string 目前13位毫秒級時間戳，3分鐘內有效
sign true string 簽名，40位大寫的sha1值
format false string 預設回傳JSON格式，若format=xml則回傳XML格式
jsonp false string 例如，正常情況{error:0,data:""}，加上jsonp=a後回傳a({error:0,data:""})

回傳結果

<xml> 
  <code>200</code>  
  <status>success</status>  
  <message>success</message>  
  <data> 
    <videoDetail> 
      <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_0_b.jpg</images_b>  
      <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_1_b.jpg</images_b>  
      <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_2_b.jpg</images_b>  
      <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_3_b.jpg</images_b>  
      <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_4_b.jpg</images_b>  
      <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_5_b.jpg</images_b>  
      <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_0.jpg</images>  
      <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_1.jpg</images>  
      <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_2.jpg</images>  
      <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_3.jpg</images>  
      <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_4.jpg</images>  
      <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_5.jpg</images>  
      <tag/>  
      <mp4>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_1.mp4</mp4>  
      <title>0001.優酷網-【經典回顧】加州旅館 2004版 中英字幕 老鷹樂隊[超清版]-0003</title>  
      <df>3</df>  
      <times>0</times>  
      <vid>38283901913ea95224af2bbd9e990ea5_3</vid>  
      <mp4_1>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_1.mp4</mp4_1>  
      <mp4_2>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_2.mp4</mp4_2>  
      <mp4_3>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_3.mp4</mp4_3>  
      <cataid>1</cataid>  
      <swf_link>http://player.polyv.net/videos/38283901913ea95224af2bbd9e990ea5_3.swf</swf_link>  
      <status>61</status>  
      <seed>0</seed>  
      <flv1>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_1.flv</flv1>  
      <flv2>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_2.flv</flv2>  
      <flv3>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_3.flv</flv3>  
      <sourcefile/>  
      <playerwidth>600</playerwidth>  
      <default_video>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_3.flv</default_video>  
      <duration>00:02:01</duration>  
      <first_image>http://img.videocc.net/uimage/3/3828390191/first_image/a15c4fe5-9fdc-4a38-adc0-2e6097757fbb_s.jpg</first_image>  
      <original_definition>1104x622</original_definition>  
      <context/>  
      <playerheight>337</playerheight>  
      <ptime>2017-04-25 11:35:06</ptime>  
      <source_filesize>22502693</source_filesize>  
      <filesize1>4755814</filesize1>  
      <filesize2>8694257</filesize2>  
      <filesize3>21784017</filesize3>  
      <md5checksum>8c6a35b5e92f84437c56de6f40b39973</md5checksum>  
      <hls>http://hls.videocc.net/3828390191/3/38283901913ea95224af2bbd9e990ea5_1.m3u8</hls>  
      <hls>http://hls.videocc.net/3828390191/3/38283901913ea95224af2bbd9e990ea5_2.m3u8</hls>  
      <hls>http://hls.videocc.net/3828390191/3/38283901913ea95224af2bbd9e990ea5_3.m3u8</hls>  
      <previewVid>v63c44pl69mnc04m6l6512ck4468m41cl_6</previewVid>  
      <uploader> 
        <email>test2@zzs.com</email>  
        <name>test2</name>  
        <role>上傳者</role> 
      </uploader>
      <keepsource>0<keepsource/>
      <hlsLevel>open</hlsLevel>
      <cataname>新建分類測試</cataname>
    </videoDetail> 
  </data> 
</xml>

JSON範例

{
    "code": 200, 
    "status": "success", 
    "message": "success", 
    "data": [
        {
            "images_b": [
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0_b.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1_b.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2_b.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_3_b.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_4_b.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_5_b.jpg"
            ], 
            "images": [
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_3.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_4.jpg", 
                "36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_5.jpg"
            ], 
            "imageUrls": [
                "http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0.jpg", 
                "http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.jpg", 
                "http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.jpg", 
                "http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_3.jpg", 
                "http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_4.jpg", 
                "http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_5.jpg"
            ], 
            "tag": "標籤", 
            "mp4": "http://mpv.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.mp4", 
            "title": "upload上傳影片", 
            "df": 2, 
            "times": "0", 
            "vid": "36e77ba39cfe07c3a3812ed7735c71ea_3", 
            "mp4_1": "http://mpv.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.mp4", 
            "mp4_2": "http://mpv.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.mp4", 
            "cataid": "1", 
            "swf_link": "http://player.polyv.net/videos/36e77ba39cfe07c3a3812ed7735c71ea_3.swf", 
            "status": "61", 
            "seed": 1, 
            "flv1": "http://plvod01.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.plv", 
            "flv2": "http://plvod01.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.plv", 
            "sourcefile": "", 
            "playerwidth": "600", 
            "default_video": "http://plvod01.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.plv", 
            "duration": "00:00:33", 
            "first_image": "http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0.jpg", 
            "original_definition": "672x378", 
            "context": "影片文件描述", 
            "playerheight": "490", 
            "ptime": "2017-12-04 09:41:10", 
            "source_filesize": 2295887, 
            "filesize": [
                1273674, 
                2262596
            ], 
            "md5checksum": "44b145c6bea7dd826191990dfb38d1fd", 
            "hls": [
                "http://hls.videocc.net/36e77ba39c/3/36e77ba39cfe07c3a3812ed7735c71ea_1.m3u8", 
                "http://hls.videocc.net/36e77ba39c/3/36e77ba39cfe07c3a3812ed7735c71ea_2.m3u8"
            ],
            "aac_link": "http://mpv.videocc.net/28ac0f40b7/8/28ac0f40b7880cca2b03ea7a8f0a8723_7.mp3",
            "tsfilesize1": "1459696", 
            "tsfilesize2": "2528832", 
            "tsfilesize3": "0", 
            "previewVid": "263c44pl69mnc04m6l6512ck4468m41cl_6", 
            "uploader": {
                "email": "test2@zzs.com", 
                "name": "test2", 
                "role": "上傳者"
            },
            "keepsource": "0",
            "hlsLevel": "open",
            "cataname": "新建分類測試"
        }
    ]
}

失敗回傳 JSON（不帶 JSONP）

{
    code: 400,
    status: "error",
    message: "ptime is too old.",
    data: ""
}

欄位說明

欄位 說明
error 錯誤提示
swf_link 回傳 Flash 連線
tag 影片標籤
mp4 MP4 原始檔案
playerwidth 影片寬度
title 標題
duration 時長
filesize 編碼後各清晰度影片的檔案大小（單位：位元組），類型為 array
first_image 影片首圖
times 播放次數
context 影片描述
original_definition 最佳解析度
images 影片截圖
playerheight 影片高度
ptime 影片上傳日期
ptime 上傳時間
vid 影片 ID
previewVid 預覽影片 ID
cataid 分類 ID，如 1 為根目錄
default_video 使用者預設播放影片
df 影片碼率數
flv1 流暢碼率 FLV 格式影片位址
flv2 高清碼率 FLV 格式影片位址
flv3 超清碼率 FLV 格式影片位址
mp4_1 流暢碼率 MP4 格式影片位址
mp4_2 高清碼率 MP4 格式影片位址
mp4_3 超清碼率 MP4 格式影片位址
hls_1 流暢清晰度的 M3U8
hls_2 高清清晰度的 M3U8
hls_3 超清清晰度的 M3U8
images_b 影片截圖大圖位址
imageUrls 影片截圖小圖 URL
seed 加密影片為 1，非加密為 0
status 影片狀態
keepsource 是否為原始檔案，否：0，是：1
uploader.email 上傳者信箱
uploader.name 上傳者名稱
uploader.role 上傳者角色，如管理員、上傳者、主帳號
hlsLevel 加密等級 open：非授權加密 web：Web 授權 app：App 授權 wxa_app：小程式授權
cataname 分類名稱
source_filesize 原始影片檔案大小，單位為 bytes
aac_link 音訊位址，需開啟音訊切換才回傳
md5checksum 上傳到 POLYV 雲平台的影片原始檔案的 MD5 值，可用來驗證是否上傳錯誤或完整
sourcefile 暫無含義
影片狀態碼 含義
60/61 已發布
10 等待編碼
20 正在編碼
40 編碼失敗
50 等待審核
51 審核不通過
-1 已刪除
PHP 請求範例 
<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
$format="json";
$jsonp="";//(注意如果這裡沒有jsonp，則不需要拼接&jsonp=參數)
$ptime=time()*1000;//13位
$vid="382839019131be68715e9455f8d0971a_3";
$secretkey="tIQp4ATe9Z";
if (empty($jsonp)) {
    $str="format=".$format."&ptime=".$ptime."&vid=".$vid.$secretkey;
}else{
    $str="format=".$format."&jsonp=".$jsonp."&ptime=".$ptime."&vid=".$vid.$secretkey;
}
//echo $str.'';
$hash=strtoupper(sha1($str));
//echo $hash.'';
$url="http://api.polyv.net/v2/video/{$userid}/get-video-msg";
$post_data = array (
    "format" => $format,
    "jsonp" => $jsonp,
    "ptime" => $ptime,
    "vid" => $vid,
    "sign" => $hash,
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// post資料
curl_setopt($ch, CURLOPT_POST, 1);
// post的變數
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
//列印獲得的資料
print_r($output);
?>

簽名規則：

將非空的請求參數按照參數名字典順序排列，連接參數名與參數值，並在尾部加上 secretkey，生成 40 位大寫 SHA1 值，作為 sign。以下是範例過程：

1、請求參數為

ptime = "1492591990000"
vid = "382839019131be68715e9455f8d0971a_3"
format = "json"

2、將請求參數按照參數名字典順序排列

format = "json"
ptime = "1492591990000"
vid = "382839019131be68715e9455f8d0971a_3"

3、連接字串 連接參數名稱與參數值，並在尾部加上 secretkey（從點播後台獲取，假設 secretkey 的值為 tIQp4ATe9Z），如下：

format=json&ptime=1492591990000&vid=382839019131be68715e9455f8d0971a_3tIQp4ATe9Z

4、產生簽名 sign

50BF9B165630A8047EB1D17D95A469CC51FF754E
联系客服，在线咨询