通用场景
图片上传
注意：
本接口为文件上传类接口，与普通openapi接口的入参构造格式不同，如果您没有使用官方sdk发起openapi调用，自行构造http请求时，需要使用multipart/form-data格式发起请求，注意以下事项：
1. 文件参数单独作为一个part，key为参数名，内容为文件，需要携带完整文件名（例如：content-disposition: form-data; name="file_content"; filename="example.png"），缺少文件名或后缀，会提示为类型错误。
2. 其余参数，对于v2版本的协议，公共参数需要使用query传入，业务参数使用query或body传入，使用body时每个字段作为一个单独part；v3协议需要按接口约定位置传入
1. 文件参数单独作为一个part，key为参数名，内容为文件，需要携带完整文件名（例如：content-disposition: form-data; name="file_content"; filename="example.png"），缺少文件名或后缀，会提示为类型错误。
2. 其余参数，对于v2版本的协议，公共参数需要使用query传入，业务参数使用query或body传入，使用body时每个字段作为一个单独part；v3协议需要按接口约定位置传入
公共请求参数
业务请求参数
image_type｜图片/视频格式必选string[1,16]
【描述】图片格式，支持格式：bmp、jpg、jpeg、png、gif.
【示例值】jpg
image_content｜图片内容必选byte[][0,10485750]
【描述】图片二进制字节流，最大为10m
【示例值】文件内容二进制流
常见请求示例
推荐示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=ant.merchant.expand.indirect.image.upload&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'image_type=jpg' \
-f 'image_content=@/home/admin/test.jpg' 说明：本示例仅供参考。
公共响应参数
业务响应参数
image_id｜图片id必选string(256)
【描述】图片在文件存储平台的标识
【示例值】a5d373f6-3e79-405f-9993-fb7ea051c372.jpg
响应示例
正常示例
异常示例
{
"ant_merchant_expand_indirect_image_upload_response": {
"code": "10000",
"msg": "success",
"image_id": "a5d373f6-3e79-405f-9993-fb7ea051c372.jpg"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| exceed_max_size | 超过单个图片允许的最大值 (10m) | 请适当压缩图片大小以免超过上传限制 |
| image_unsafe | 文件未通过安全校验 | 图片中可能注入了恶意代码,请重新制作图片 |
| invalid_image_format | 文件格式不支持 | 请不要使用非常用的图片格式,如cmyk |
| merchant_illegal_argument | 参数格式非法 | 参数格式非法，请检查 |