最新更新時間:2020.09.02 版本說明
商戶上傳反饋圖片的接口。 將媒體圖片進行二進制轉(zhuǎn)換,得到的媒體圖片二進制內(nèi)容,在請求body中上傳此二進制內(nèi)容。 媒體圖片只支持jpg、png、bmp格式,文件大小不能超過2M。
1.創(chuàng)建一個POST的方法請求/upload URI
例如: POST https://api.mch.weixin.qq.com/v3/merchant-service/images/upload HTTP/1.1
2.將文件的數(shù)據(jù)添加到請求主體
2.1 圖片文件file參數(shù)的獲取方式說明:
媒體圖片二進制內(nèi)容,放在請求http的body中。
2.2 媒體文件元信息meta參數(shù)的獲取方式說明:
媒體文件元信息,使用json表示,包含兩個對象:filename、sha256。
● filename參數(shù)獲取方式說明:
商戶上傳的媒體圖片的名稱,商戶自定義,必須以jpg、png、bmp為后綴。
● sha256參數(shù)獲取方式說明:
圖片文件的文件摘要,即對圖片文件的二進制內(nèi)容進行sha256計算得到的值。
2.3 簽名計算說明:
https://wechatpay-api.gitbook.io/wechatpay-api-v3/qian-ming-zhi-nan-1/qian-ming-sheng-cheng
參與簽名計算的請求主體為meta的json串:
{ "filename": "filea.jpg", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }
待簽名串示例:
POST
/v3/merchant/media/upload
1566987169 //時間戳
12ced2db6f0193dda91ba86224ea1cd8 //隨機數(shù)
{"filename":" filea.jpg ","sha256":" hjkahkjsjkfsjk78687dhjahdajhk "}
3.添加HTTP頭:
Content-Type:multipart/form-data.設(shè)置為要上載的對象的MIME媒體類型。
Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900231671",
nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",timestamp="1567067659",
serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7SFR+BjDZh6
89hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPNQ7dBLO7ux6MoSuQp69
PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e7hwUbDwGln170ZXomoO1KpQSbw3f1u
WUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
Content-Type: multipart/form-data;boundary=boundary
4.添加body:
// 以下為body的內(nèi)容
--boundary // boundary為商戶自定義的一個字符串
Content-Disposition: form-data; name="meta";
Content-Type: application/json
//此處必須有一個空行
{ "filename": "filea.jpg", "sha256": " hjkahkjsjkfsjk78687dhjahdajhk " }
--boundary
Content-Disposition: form-data; name="file"; filename="filea.jpg";
Content-Type: image/jpg
//此處必須有一個空行
pic1 //pic1即為媒體圖片的二進制內(nèi)容
--boundary--
說明:請求包體每行結(jié)尾都需要包含\r\n(空行也需要)。
5.發(fā)送請求
POST /v3/merchant/media/upload HTTP/1.1
Host: api.mch.weixin.qq.com
Authorization: WECHATPAY2-SHA256-RSA2048
mchid="1900231671",nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",
timestamp="1567067659",
serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7
SFR+BjDZh689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPN
Q7dBLO7ux6MoSuQp69PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e
7hwUbDwGln170ZXomoO1KpQSbw3f1uWUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M
7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
Content-Type: multipart/form-data;boundary=boundary
--boundary
Content-Disposition: form-data; name="meta";
Content-Type: application/json
{ "filename": "filea.jpg", "sha256": " hjkahkjsjkfsjk78687dhjahdajhk " }
--boundary
Content-Disposition: form-data; name="file"; filename="filea.jpg";
Content-Type: image/jpg
pic1
--boundary--
適用對象:直連商戶 服務(wù)商 渠道商
請求URL:https://api.mch.weixin.qq.com/v3/merchant-service/images/upload
請求主體類型:multipart/form-data
請求方式:POST
接口規(guī)則:http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
圖片文件 | file | message | 是 | body 將媒體圖片進行二進制轉(zhuǎn)換,得到的媒體圖片二進制內(nèi)容,在請求body中上傳此二進制內(nèi)容。媒體圖片只支持jpg、png、bmp格式,文件大小不能超過2M。 示例值:pic1 |
+媒體文件元信息 | meta | Object | 是 | body 媒體文件元信息,使用json表示,包含兩個對象:filename、sha256。 |
參數(shù)名 | 變量 | 類型[長度限制][長度限制] | 必填 | 描述 |
---|---|---|---|---|
媒體文件標識 ID | media_id | string[1,512] | 是 | 微信返回的媒體文件標識ID。 示例值:BB04A5DEEFEA18D4F2554C1EDD3B610B.bmp |
{
"media_id": "BB04A5DEEFEA18D4F2554C1EDD3B610B.bmp"
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 5開頭的狀態(tài)碼都為系統(tǒng)問題,請使用相同參數(shù) 稍后重新調(diào)用 |
400 | PARAM_ERROR | 參數(shù)錯誤 | 根據(jù)錯誤提示,傳入正確參數(shù) |
429 | FREQUENCY_LIMITED | 頻率超限 | 請求量不要超過接口調(diào)用頻率限制 |
400 | INVALID_REQUEST | 請求參數(shù)符合參數(shù)格式,但不符合業(yè)務(wù)規(guī)則 | 請確認相同單號是否使用了不同的參數(shù) |
401 | SIGN_ERROR | 簽名驗證失敗 | 請檢查簽名參數(shù)和方法是否都符合簽名算法要求 |
403 | NO_AUTH | 商戶暫無權(quán)限使用此功能 | 請開通商戶號權(quán)限。請聯(lián)系產(chǎn)品或商務(wù)申請 |