图片上传接口

更新时间:2023.09.06

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

# 接口说明

支持商户:
【普通商户】
请求方式:
【POST】/v3/merchant-service/images/upload
请求域名:
【主域名】
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
  • file 必填 file
    将媒体图片进行二进制转换,得到的媒体图片二进制内容,在请求body中上传此二进制内容。媒体图片只支持jpg、bmp、png格式,文件大小不能超过2M
  • meta 必填 ImageMetaInfo
    包括文件名称和文件摘要
    • 属性

请求示例

POST

# 应答参数

    200OK
  • media_id 必填 string(512)
    【媒体文件标识Id】 微信返回的媒体文件标识Id,用于提交交易投诉反馈时填写

应答示例

200 OK

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
400 INVALID_REQUEST HTTP 请求不符合微信支付 APIv3 接口规则 请参阅 接口规则
401 SIGN_ERROR 验证不通过 请参阅 签名常见问题
500 SYSTEM_ERROR 系统异常,请稍后重试 请稍后重试

# 业务错误码

状态码 错误码 描述 解决方案
反馈
咨询
目录