图片上传

更新时间:2024.11.05
||

电商平台服务商调用注销申请接口时,需要先调用本接口上传相关的资料图片,获取图片ID后,再填写到注销申请请求中。

接口说明

支持商户:【普通服务商】【平台商户】

请求方式:【POST】/v3/ecommerce/account/cancel-applications/media

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数
折叠全部参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


 Content-Type  必填 string

请设置为multipart/form-data


BODY  包体参数

 file  必填   message

将媒体图片进行二进制转换,得到的媒体图片二进制内容,在请求body中上传此二进制内容。媒体图片只支持JPG、BMP、PNG格式,文件大小不能超过2M。


 meta  必填   object

媒体文件元信息

属性

 file_name  必填   string(128)

【文件名称】商户上传的媒体图片的名称,商户自定义,必须以JPG、BMP、PNG为后缀。


 file_digest  必填   string(64)

【文件摘要】图片文件的文件摘要,即对图片文件的二进制内容进行sha256计算得到的值,大小写均可。

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/ecommerce/account/cancel-applications/media \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: multipart/form-data" \
6  -F file=@"/path/to/file" \
7  -F meta="{
8    "file_name" : "filea.jpg",
9    "file_digest" : "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"
10  }"

应答参数

200 OK

 media_id  必填  string(512)

【媒体文件标识ID】微信返回的媒体文件标识ID

应答示例

200 OK

1{
2  "media_id" : "6uqyGjGrCf2GtyXP8bxrbuH9-aAoTjH-rKeSl3Lf4_So6kdkQu4w8BYVP3bzLtvR38lxt4PjtCDXsQpzqge_hQEovHzOhsLleGFQVRF-U_0"
3}
4

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

500

SYSTEM_ERROR

系统错误

系统异常,请使用相同参数稍后重新调用

400

INVALID_REQUEST

图片内容过大

图片内容大小超出限制,请使用2M以内的图片

400

INVALID_REQUEST

图片Content-Type非法

请更换为JPG、JPEG、BMP、PNG格式的图片

 

 

反馈
目录
置顶