1. 接口說(shuō)明

適用對(duì)象：直連模式 機(jī)構(gòu)模式

請(qǐng)求URL：https://apihk.mch.weixin.qq.com/v3/global/merchant-storage/file/upload

請(qǐng)求主體類型：multipart/form-data

請(qǐng)求方式：POST

2. 請(qǐng)求參數(shù)

3. 各語(yǔ)言請(qǐng)求示例

---示例代碼待更新---

4. 返回參數(shù)

返回示例

{
  "file_id": "b6a17e2a-1dc4-4376-8630-e73d06490c0d"
}

{
    "appid": "wx7bc98d929da735fe",

  }

									{
										"stock_id": ".NET",
										"limit": 10,
									}

									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

5. 請(qǐng)求步驟

5.1. 創(chuàng)建一個(gè)POST方法請(qǐng)求

例如：

POST https://apihk.mch.weixin.qq.com/v3/global/merchant-storage/file/upload HTTP/1.1

{
    "appid": "wx7bc98d929da735fe",

  }

									{
										"stock_id": ".NET",
										"limit": 10,
									}

									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

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

5.2.1 文件信息file參數(shù)的獲取方式說(shuō)明：
將文件進(jìn)行二進(jìn)制轉(zhuǎn)換，得到的二進(jìn)制內(nèi)容， 放在請(qǐng)求http的body中。

5.2.2 文件元信息meta參數(shù)的獲取方式說(shuō)明：
文件元信息，使用json表示，包含兩個(gè)對(duì)象：filename、digest。
● filename參數(shù)獲取方式說(shuō)明：
商戶上傳文件的名稱，商戶自定義，必須以PDF、JPG、BMP、PNG為后綴。
● digest參數(shù)獲取方式說(shuō)明：
文件摘要，即對(duì)上傳文件的二進(jìn)制內(nèi)容進(jìn)行sha256計(jì)算得到的值。

5.2.3 簽名計(jì)算說(shuō)明：
簽名生成
參與簽名計(jì)算的請(qǐng)求主體為meta的json串：
? {"filename": "file1.pdf", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk"}

Example of a string to be signed：

POST
/v3/global/merchant-storage/file/upload
1566987169           // 時(shí)間戳
12ced2db6f0193dda91ba86224ea1cd8   // 隨機(jī)數(shù)
{"filename": "file1.pdf", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk"} 

5.3.添加HTTP頭：

Content-Type：multipart/form-data.設(shè)置為要上載的對(duì)象的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

5.4.添加body：

// 以下為body的內(nèi)容
--boundary  // boundary為商戶自定義的一個(gè)字符串
Content-Disposition: form-data; name="meta";
Content-Type: application/json
//此處必須有一個(gè)空行
{"filename": "file1.pdf", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk"} 
--boundary
Content-Disposition: form-data; name="file"; filename="file1.pdf";
Content-Type: application/pdf
//此處必須有一個(gè)空行
context123    //context123即為所要上傳文件的二進(jìn)制內(nèi)容
--boundary--

說(shuō)明：請(qǐng)求包體每行結(jié)尾都需要包含\r\n（空行也需要）。

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

POST /v3/global/merchant-storage/file/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": "file1.pdf", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk"} 
--boundary
Content-Disposition: form-data; name="file"; filename="file1.pdf";
Content-Type: application/pdf

context123
--boundary--

6. 錯(cuò)誤碼