1.1.用途

雲視睿博視頻轉碼系統（以下簡稱“轉碼系統”）可以將轉碼後的視頻文件通過HTTP協議上傳到服務器上。
默認情況下，給出一個可以上傳文件的HTTP地址即可。為了滿足更復雜的應用需求，轉碼系統還支持更靈活的上傳方式，本文檔定義轉碼系統的上傳規則。開發人員可以參考本規則實現上傳服務器的服務端邏輯。

1.2.通信協議

本規範中，接收數據的服務器是通信的服務器端（簡稱“服務器”），轉碼系統是通信客戶端。客戶端和服務器通過HTTP協議通信，客戶端使用HTTP Get向服務器發送請求，服務器返回json格式的數據給客戶端。服務器可以是任何能夠按本規範提供服務的第三方系統，如雲視睿博的流媒體服務器系統和內容管理系統。

1.3.必要條件

如果要讓轉碼系統按照本接口規範訪問接口和上傳文件，請在轉碼系統的設置界面中，將“上傳位置滿足雲視規範”的選項勾選上，如下圖：

2.查詢上傳位置

客戶端通過訪問服務器提供的接口位置，獲取實際的上傳位置和回調位置。接口位置是符合HTTP規範的URL地址。
客戶端通過HTTP GET請求接口，服務器收到請求後，返回如下格式的json數據：

{
    "code": 0,
    "data": {
        "upload": "http:\/\/192.168.1.11\/upload\/?sub_path=&field_name=field1",
        "callback": "http:\/\/192.168.1.11\/mserver\/interface\/src=_FILENAME&src_id=_SRC_ID&title=_TITLE"
    }
}
 

如果不可上傳，返回code不等於零的json數據，按如下格式返回錯誤：

{
"code":100,
"err_desc":"\u7f3a\u5c11\u5fc5\u8981\u53c2\u6570"
}

其中：
upload 是實際上傳文件的位置，客戶端將通過HTTP POST向該位置上傳文件。
callback 是文件上傳結束後的回調位置，可以忽略。
如果提供callback位置，在文件正確上傳完畢後，客戶端會調用該接口，並在調用之前試圖替換接口中的如下字符串：
_FILENAME 上傳文件名，用實際的文件名替換
_SRC_ID 用文件名去掉後綴的部分替換
_TITLE 用文件名去掉後綴的部分替換，或者用明確設定的文件標題替換

{
"code":0
}

失敗返回code非零的數據：

{
"code":100,
"err_desc":"。。。"
}

3.文件上傳

轉碼系統使用HTTP POST協議向upload位置上傳文件。POST數據采用multipart/form-data編碼。

視頻轉碼系統文件上傳接口規範