视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

圖片上傳(營(yíng)銷專用)

更新時(shí)間:2023.08.23

通過本接口上傳圖片后可獲得圖片URL地址。圖片URL可在微信支付營(yíng)銷相關(guān)的API使用,包括商家券、代金券、支付有禮等。

# 接口說明

支持商戶:
【普通服務(wù)商】
請(qǐng)求方式:
【POST】/v3/marketing/favor/media/image-upload
請(qǐng)求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點(diǎn)
【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點(diǎn) ,指引點(diǎn)擊查看

# 字段說明

# 請(qǐng)求參數(shù)

    Body 包體參數(shù)
  • file 必填 message
    將媒體圖片進(jìn)行二進(jìn)制轉(zhuǎn)換,得到的媒體圖片二進(jìn)制內(nèi)容,在請(qǐng)求body中上傳此二進(jìn)制內(nèi)容。媒體圖片只支持JPG、BMP、PNG格式,文件大小不能超過2M。
  • meta 必填 Object
    媒體文件元信息,使用json表示,包含兩個(gè)對(duì)象:filename、sha256。
    • 屬性

請(qǐng)求示例

示例代碼

JAVA詳細(xì)請(qǐng)求示例見:wechatpay-apache-httpclient (opens new window)

PHP詳細(xì)請(qǐng)求示例見:wechatpay-guzzle-middleware (opens new window)

# 應(yīng)答字段

    200OK
  • media_url 必填 string(256)
    微信返回的媒體文件標(biāo)識(shí)URL。有效期為永久

應(yīng)答示例

200 OK

# 請(qǐng)求步驟

# 圖片上傳步驟

# 1. 創(chuàng)建一個(gè)POST的方法請(qǐng)求/upload URI

例如: POST https://api.mch.weixin.qq.com/v3/marketing/favor/media/image-upload HTTP/1.1

# 2. 將文件的數(shù)據(jù)添加到請(qǐng)求主體

2.1. 圖片文件file參數(shù)的獲取方式說明:

媒體圖片二進(jìn)制內(nèi)容,放在請(qǐng)求HTTP的body中。

2.2. 媒體文件元信息meta參數(shù)的獲取方式說明:

媒體文件元信息,使用json表示,包含兩個(gè)對(duì)象:filename、sha256。

  • filename參數(shù)獲取方式說明:

商戶上傳的媒體圖片的名稱,商戶自定義,必須以JPG、BMP、PNG為后綴。

  • sha256參數(shù)獲取方式說明:

圖片文件的文件摘要,即對(duì)圖片文件的二進(jìn)制內(nèi)容進(jìn)行sha256計(jì)算得到的值。

2.3. 簽名計(jì)算說明:

簽名生成

參與簽名計(jì)算的請(qǐng)求主體為meta的json串:

{ "filename": "filea.jpg", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }

待簽名串示例:

1POST
2/v3/marketing/favor/media/image-upload
31566987169 //時(shí)間戳
412ced2db6f0193dda91ba86224ea1cd8 //隨機(jī)數(shù)
5{"filename":"filea.jpg","sha256":"hjkahkjsjkfsjk78687dhjahdajhk"}

# 3. 添加HTTP頭

1Content-Type:multipart/form-data.設(shè)置為要上載的對(duì)象的MIME媒體類型。
2Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900231671",
3nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",timestamp="1567067659",
4serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
5signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7SFR+BjDZh6
689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPNQ7dBLO7ux6MoSuQp69
7PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e7hwUbDwGln170ZXomoO1KpQSbw3f1u
8WUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
9Content-Type: multipart/form-data;boundary=boundary

# 4. 添加body

1// 以下為body的內(nèi)容
2--boundary // boundary為商戶自定義的一個(gè)字符串
3Content-Disposition: form-data; name="meta";
4Content-Type: application/json
5//此處必須有一個(gè)空行
6{ "filename": "filea.jpg", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }
7--boundary
8Content-Disposition: form-data; name="file"; filename="filea.jpg";
9Content-Type: image/jpg
10//此處必須有一個(gè)空行
11pic1 //pic1即為媒體圖片的二進(jìn)制內(nèi)容
12--boundary--

注意

請(qǐng)求包體每行結(jié)尾都需要包含\r\n(空行也需要)。

# 5.發(fā)送請(qǐng)求

1POST /v3/marketing/favor/media/image-upload HTTP/1.1
2Host: api.mch.weixin.qq.com
3Authorization: WECHATPAY2-SHA256-RSA2048
4mchid="1900231671",nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",
5timestamp="1567067659",
6serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
7signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7
8SFR+BjDZh689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPN
9Q7dBLO7ux6MoSuQp69PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e
107hwUbDwGln170ZXomoO1KpQSbw3f1uWUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M
117aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
12Content-Type: multipart/form-data;boundary=boundary
13
14--boundary
15Content-Disposition: form-data; name="meta";
16Content-Type: application/json
17
18{ "filename": "filea.jpg", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }
19--boundary
20Content-Disposition: form-data; name="file"; filename="filea.jpg";
21Content-Type: image/jpg
22
23pic1
24--boundary--

# 錯(cuò)誤碼

狀態(tài)碼 錯(cuò)誤碼 描述 解決方案
400 PARAM_ERROR 圖片文件為空 商戶更換文件后,重新調(diào)用
403 REQUEST_BLOCKED 未知圖片類型 圖片類型必須為JPG、BMP、PNG
403 REQUEST_BLOCKED 圖片meta信息不一致 請(qǐng)檢查meta信息是否正確
403 REQUEST_BLOCKED 簽名信息不匹配 請(qǐng)檢查簽名信息