最新更新时间:2021.08.27 版本说明
下载图片API为通用接口,消费者投诉相关图片都可以通过该接口进行下载。
• 该接口响应的信息请求头中不包含微信接口响应的签名值,因此需要跳过验签的流程。
适用对象: 服务商 渠道商 从业机构
请求URL:通过查询接口获取到media_url
请求方式:GET
前置条件:通过查询接口获取到media_url
当获取到投诉资料信息后,如:
{
"media_type": "USER_COMPLAINT_IMAGE",
"media_url": "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
}
可以通过微信支付API v3标准对media_url进行签名,并发起请求,即可下载到图片的数据流。
$ curl https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx -H '
Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900009191",
nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",
signature="uOVRnA4qG/MNnYzdQxJanN+zU+lTgIcnU9BxGw5dKjK+VdEUz2FeIoC+D5sB/LN+nGzX3hfZg6r5
wT1pl2ZobmIc6p0ldN7J6yDgUzbX8Uk3sD4a4eZVPTBvqNDoUqcYMlZ9uuDdCvNv4TM3c1WzsXUrExwVkI
1XO5jCNbgDJ25nkT/c1gIFvqoogl7MdSFGc4W4xZsqCItnqbypR3RuGIlR9h9vlRsy7zJR9PBI83X8al
LDIfR1ukt1P7tMnmogZ0cuDY8cZsd8ZlCgLadmvej58SLsIkVxFJ8XyUgx9FmutKSYTmYtWBZ0+tNvfGmbXU7cob8H/
4nLBiCwIUFluw==",timestamp="1554208460",serial_no="1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C"'
返回格式为图片文件的标准二进制数据流,会对回包Content-Type进行设置。
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系统错误 | 5开头的状态码都为系统问题,请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 参数错误 | 请填写正确的url请求参数 |
400 | INVALID_REQUEST | 请求参数符合参数格式,但不符合业务规则项 | 请确认参数符合业务要求,稍后重新调用 |
401 | SIGN_ERROR | 签名验证失败 | 请检查签名参数和方法是否都符合签名算法要求 |
403 | NO_AUTH | 无权限 | 请开通商户号权限,并确认参数符合规范 |
404 | RESOURCE_NOT_EXISTS | 资源不存在 | 请确认请求参数正确,并使用微信支付API v3标准发起请求 |
429 | FREQUENCY_LIMITED | 频率超限 | 请求量不要超过接口调用频率限制 |