保利威文档中心

幫助中心

修改影片資訊

更新時間：2025-01-14 14:42:44

介面說明

1、通过视频id修改视频信息
2、接口URL中的{userid}为点播账号userid，具体参考菜单【使用须知】->【获取密钥】
3、接口支持https协议

介面URL

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

線上API呼叫

請求方式

POST

介面限制

1、介面同時支援HTTP、HTTPS，建議使用HTTPS以確保介面安全，介面呼叫有頻率限制，詳細請查看

請求參數說明

參數名 必填 類型 說明
ptime true Long 目前時間的毫秒級時間戳，3分鐘內有效
sign true String 簽名，為40位大寫的SHA1值，產生簽名的secretkey金鑰作為通訊資料安全的關鍵資訊，嚴禁儲存在用戶端直接使用，所有API都必須透過客戶自己的伺服器轉發呼叫POLYV伺服器取得回應資料【詳見簽名產生規則】
vid true String 影片ID
describ false String 影片描述
format false String 回傳的資料格式，預設回傳json格式
xml：回傳xml格式
json：回傳json格式
publishUrl false String 影片首發外部連結
tag false String 影片標籤
title false String 影片標題

範例

http://api.polyv.net/v2/video/1b448be323/video-info

表單參數：

vid=1b448be323871ffe3d5a84a3638e82c2_1&describ=%E4%BF%9D%E5%88%A9%E5%A8%81%E6%98%AF%E5%85%A8%E7%90%83%E9%A2%86%E5%85%88%E7%9A%84%E4%BC%81%E4%B8%9A%E7%9B%B4%E6%92%AD%E6%9C%8D%E5%8A%A1%E5%95%86%EF%BC%8C%E9%9A%B6%E5%B1%9E%E4%BA%8E%E5%B9%BF%E5%B7%9E%E6%98%93%E6%96%B9%E4%BF%A1%E6%81%AF%E7%A7%91%E6%8A%80%E8%82%A1%E4%BB%BD%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8%EF%BC%8C%E8%87%B4%E5%8A%9B%E4%BA%8E%E9%80%9A%E8%BF%87%E5%8F%AF%E9%9B%86%E6%88%90%E3%80%81%E5%8F%AF%E5%AE%9A%E5%88%B6%E7%9A%84%E8%A7%86%E9%A2%91%E7%9B%B4%E6%92%AD%E6%8A%80%E6%9C%AF%EF%BC%8C%E4%B8%BA%E4%BC%81%E4%B8%9A%E6%90%AD%E5%BB%BA%E8%87%AA%E4%B8%BB%E7%A7%81%E5%9F%9F%E7%9B%B4%E6%92%AD%E7%B3%BB%E7%BB%9F%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9B%E7%9B%B4%E6%92%AD%E5%85%A8%E6%B5%81%E7%A8%8B%E8%BF%90%E8%90%A5%E4%B8%8E%E7%8E%B0%E5%9C%BA%E6%89%A7%E8%A1%8C%E6%9C%8D%E5%8A%A1%E3%80%82&sign=5AA9AF13716BCFF428B7E4C2F59930BDEF1DD901&tag=%E5%AE%A3%E4%BC%A0%E8%A7%86%E9%A2%91&title=%E4%BF%9D%E5%88%A9%E5%A8%81%E5%AE%A3%E4%BC%A0%E8%A7%86%E9%A2%91&ptime=1670903195195&publishUrl=http%3A%2F%2Fwww.polyv.net

回應參數說明

參數名 類型 說明
code Integer 回應狀態碼，200為成功回傳，非200為失敗【詳見全域錯誤說明】
status String 回應狀態文字資訊
message String 回應描述資訊，當code為400或500時，輔助描述錯誤原因
data Array 回應成功時回傳影片詳細資訊【詳見data欄位說明】

data欄位說明

參數名 類型 說明
images_b String[] 影片截圖大圖網址
images String[] 影片截圖小圖網址
imageUrls String[] 影片截圖存取連結
tag String 影片標籤
mp4 String 流暢碼率mp4格式影片網址
title String 影片標題
df Integer 影片碼率數
times String 播放次數
vid String 影片ID
mp4_1 String 流暢碼率mp4格式影片網址
mp4_2 String 高清碼率mp4格式影片網址
mp4_3 String 超清碼率mp4格式影片網址
cataid String 分類ID，如1為預設分類
swf_link String 回傳flash連結
status String 影片狀態
60/61：已發佈
10：等待編碼
20：正在編碼
50：等待審核
51：審核不通過
-1：已刪除
seed Integer 加密影片為1，非加密為0
flv1 String 流暢碼率flv格式影片網址
flv2 String 高清碼率flv格式影片網址
flv3 String 超清碼率flv格式影片網址
sourcefile String 原始檔案
playerwidth String 影片寬度
default_video String 使用者預設播放影片
duration String 影片長度，格式：時:分:秒，如：00:00:48
first_image String 影片首圖
original_definition String 最佳解析度
context String 影片描述
playerheight String 影片高度
ptime String 上傳時間
source_filesize Long 原始檔案大小，單位：byte
filesize Long[] 編碼後各清晰度影片的檔案大小，單位：byte
md5checksum String md5校驗值
hls String[] 編碼後各清晰度影片的m3u8網址
keepsource String 是否為原始檔案，否：0，是：1
uploader Object 上傳者資訊【詳見uploader欄位說明】
cataname String 分類名稱

uploader欄位說明

參數名 類型 說明
email String 上傳者信箱
name String 上傳者名稱
role String 上傳者角色，如管理員、上傳者、主帳號

Java請求範例

快速接入基礎程式碼請下載相關依賴原始碼，點擊下載原始碼，下載後加入自己的原始碼工程中即可。測試案例中的HttpUtil.java 和 VodSignUtil.java 都包含在下載檔案中。

強烈建議您使用點播Java SDK完成API的功能對接，點播Java SDK 對API呼叫邏輯、異常處理、資料簽名、HTTP請求執行緒池進行了統一封裝和最佳化。

 private static final Logger log = LoggerFactory.getLogger(VodVideoManagementTest.class);
/**
 * 修改视频信息
 */
@Test
public void testUpdateVideoInfo() throws Exception, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String secretKey = super.secretKey;
    String userId = super.userId;
    String ptime = String.valueOf(System.currentTimeMillis());
    //业务参数
    String url = "http://api.polyv.net/v2/video/" + userId + "/video-info";
    
    String vid = "1b448be323871ffe3d5a84a3638e82c2_1";
    String title = "保利威宣传视频";
    String describ = "保利威是全球领先的企业直播服务商，隶属于广州易方信息科技股份有限公司，致力于通过可集成、可定制的视频直播技术，为企业搭建自主私域直播系统，并提供直播全流程运营与现场执行服务。";
    String tag = "宣传视频";
    String publishUrl = "http://www.polyv.net";
    
    Map<String, String> requestMap = new HashMap<>();
    requestMap.put("userId", userId);
    requestMap.put("ptime", ptime);
    requestMap.put("vid", vid);
    requestMap.put("describ", describ);
    requestMap.put("tag", tag);
    requestMap.put("title", title);
    requestMap.put("publishUrl", publishUrl);
    
    requestMap.put("sign", VodSignUtil.getSign(requestMap, secretKey));
    String response = HttpUtil.postFormBody(url, requestMap);
    log.debug("测试修改视频信息,{}", response);
    //do somethings
}

回應範例

系統全域錯誤說明詳見全域錯誤說明

成功範例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": [
        {
            "images_b": [
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_0_b.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1_b.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2_b.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3_b.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_4_b.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_5_b.jpg"
            ],
            "images": [
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_0.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_4.jpg",
                "1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_5.jpg"
            ],
            "imageUrls": [
                "http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_0.jpg",
                "http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.jpg",
                "http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.jpg",
                "http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.jpg",
                "http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_4.jpg",
                "http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_5.jpg"
            ],
            "tag": "宣传视频",
            "mp4": "http://mpv.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.mp4",
            "title": "保利威宣传视频",
            "df": 3,
            "times": "0",
            "vid": "1b448be323871ffe3d5a84a3638e82c2_1",
            "mp4_1": "http://mpv.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.mp4",
            "mp4_2": "http://mpv.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.mp4",
            "mp4_3": "http://mpv.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.mp4",
            "cataid": "1",
            "swf_link": "http://player.polyv.net/videos/1b448be323871ffe3d5a84a3638e82c2_1.swf",
            "status": "61",
            "seed": 1,
            "flv1": "http://plvod01.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.mp4",
            "flv2": "http://plvod01.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.mp4",
            "flv3": "http://plvod01.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.mp4",
            "sourcefile": "",
            "playerwidth": "600",
            "default_video": "http://plvod01.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.mp4",
            "duration": "00:01:49",
            "first_image": "http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_0_b.jpg",
            "original_definition": "1920x1080",
            "context": "保利威是全球领先的企业直播服务商，隶属于广州易方信息科技股份有限公司，致力于通过可集成、可定制的视频直播技术，为企业搭建自主私域直播系统，并提供直播全流程运营与现场执行服务。",
            "playerheight": "337",
            "ptime": "2022-12-12 17:47:19",
            "source_filesize": 18839865,
            "filesize": [
                7774918,
                14508330,
                18866914
            ],
            "md5checksum": "4b88804c015da508b5008f95846befc1",
            "hls": [
                "http://hls.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.m3u8",
                "http://hls.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.m3u8",
                "http://hls.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.m3u8"
            ],
            "uploader": {
                "email": "sdk-demo@polyv.net",
                "name": "sdk功能测试账号",
                "role": "主账号"
            },
            "keepsource": "",
            "cataname": "默认分类"
        }
    ]
}

異常範例

{
    "code": 400,
    "status": "error",
    "message": "请先选择目标视频。",
    "data": ""
}
联系客服，在线咨询