部分微信支付業(yè)務(wù)指定商戶需要使用視頻上傳 API來上報視頻信息,從而獲得必傳參數(shù)的值:視頻MediaID 。
# 接口說明
支持商戶:
【普通服務(wù)商】
請求方式:
【POST】/v3/merchant/media/video_upload
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 字段說明
# 請求參數(shù)
- file 必填 message將媒體視頻進(jìn)行二進(jìn)制轉(zhuǎn)換,得到的媒體視頻二進(jìn)制內(nèi)容,在請求body中上傳此二進(jìn)制內(nèi)容。媒體視頻只支持avi、wmv、mpeg、mp4、mov、mkv、flv、f4v、m4v、rmvb格式,文件大小不能超過5M。
- meta 必填 Object媒體文件元信息,使用json表示,包含兩個對象:filename、sha256。
- 屬性
Body 包體參數(shù)
請求示例
示例代碼
JAVA詳細(xì)請求示例見:wechatpay-apache-httpclient (opens new window)
PHP詳細(xì)請求示例見:wechatpay-guzzle-middleware (opens new window)
# 應(yīng)答字段
- media_id 必填 string(512)微信返回的媒體文件標(biāo)識ID。
200OK
應(yīng)答示例
200 OK
# 請求步驟
# 視頻上傳步驟
# 1. 創(chuàng)建一個POST的方法請求/upload URI
例如: POST https://api.mch.weixin.qq.com/v3/merchant/media/video_upload HTTP/1.1
# 2. 將文件的數(shù)據(jù)添加到請求主體
2.1. 視頻文件file參數(shù)的獲取方式說明:
媒體視頻二進(jìn)制內(nèi)容,放在請求HTTP的body中。
2.2. 媒體文件元信息meta參數(shù)的獲取方式說明:
媒體文件元信息,使用json表示,包含兩個對象:filename、sha256。
- filename參數(shù)獲取方式說明:
商戶上傳的媒體視頻的名稱,商戶自定義,必須以avi、wmv、mpeg、mp4、mov、mkv、flv、f4v、m4v、rmvb為后綴。
- sha256參數(shù)獲取方式說明:
視頻文件的文件摘要,即對視頻文件的二進(jìn)制內(nèi)容進(jìn)行sha256計算得到的值。
2.3. 簽名計算說明:
簽名生成
參與簽名計算的請求主體為meta的json串:
{ "filename": "filea.mp4", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }
待簽名串示例:
1POST2/v3/merchant/media/video_upload31566987169 //時間戳412ced2db6f0193dda91ba86224ea1cd8 //隨機數(shù)5{"filename":"filea.mp4","sha256":"hjkahkjsjkfsjk78687dhjahdajhk"}
# 3. 添加HTTP頭
1Content-Type:multipart/form-data.設(shè)置為要上載的對象的MIME媒體類型。2Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900231671",nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",3timestamp="1567067659",serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",4signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7SFR+BjDZh689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPNQ7dBLO7ux6MoSuQp69PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e7hwUbDwGln170ZXomoO1KpQSbw3f1uWUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="5Content-Type: multipart/form-data;boundary=boundary
# 4. 添加body
1// 以下為body的內(nèi)容2--boundary // boundary為商戶自定義的一個字符串3Content-Disposition: form-data; name="meta";4Content-Type: application/json5//此處必須有一個空行6{ "filename": "file_test.mp4", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }7--boundary8Content-Disposition: form-data; name="file"; filename="file_test.mp4";9Content-Type: video/mp410//此處必須有一個空行11pic1 //pic1即為媒體視頻的二進(jìn)制內(nèi)容12--boundary--
注意
請求包體每行結(jié)尾都需要包含\r\n(空行也需要)。
# 5.發(fā)送請求
1POST /v3/merchant/media/video_upload HTTP/1.12Host: api.mch.weixin.qq.com3Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900231671",nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",timestamp="1567067659",serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7SFR+BjDZh689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPNQ7dBLO7ux6MoSuQp69PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e7hwUbDwGln170ZXomoO1KpQSbw3f1uWUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="4 Content-Type: multipart/form-data;boundary=boundary56--boundary 7Content-Disposition: form-data; name="meta";8Content-Type: application/json910{ "filename": "file_test.mp4", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }11--boundary12Content-Disposition: form-data; name="file"; filename="file_test.mp4";13Content-Type: video/mp41415pic116--boundary--
# 錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調(diào)用 |
500 | SYSTEM_ERROR | 文件系統(tǒng)錯誤,請稍后重試 | 文件系統(tǒng)異常,請使用相同參數(shù)稍后重新調(diào)用 |
400 | PARAM_ERROR | 視頻文件名稱不正確,請檢查后重新提交 | 視頻文件名稱不正確,只支持avi、wmv、mpeg、mp4、mov、mkv、flv、f4v、m4v、rmvb,請使用正確視頻文件重新調(diào)用 |
400 | PARAM_ERROR | 文件二進(jìn)制內(nèi)容不是視頻,請檢查后重新提交 | 上傳文件二進(jìn)制內(nèi)容頭部不正確,只支持avi、wmv、mpeg、mp4、mov、mkv、flv、f4v、m4v、rmvb,請使用正確視頻文件重新調(diào)用 |
400 | PARAM_ERROR | 視頻sha256值有誤,請檢查后重新提交 | 視頻sha256值計算有誤,請檢查算法,重新計算后提交 |
400 | PARAM_ERROR | 文件大小不能超過5M,請檢查后重新提交 | 商戶更換文件或者對視頻進(jìn)行壓縮后,重新調(diào)用 |
400 | PARAM_ERROR | 文件為空,請檢查后重新提交 | 商戶更換文件后,重新調(diào)用 |
429 | FREQUENCY_LIMIT_EXCEED | 操作過快,請稍后重試 | 請商戶降低每秒調(diào)用頻率 |
429 | FREQUENCY_LIMIT_EXCEED | 當(dāng)天上傳文件數(shù)已達(dá)上限 | 請商戶降低每天調(diào)用頻率 |
403 | NO_AUTH | 商戶權(quán)限異常 | 請確認(rèn)是否已經(jīng)開通相關(guān)權(quán)限 |