通用场景
商户把商品对应的图片文件、普通文件信息上传到支付宝，后续通过该接口返回的素材id来和支付宝交互
注意：
本接口为文件上传类接口，与普通openapi接口的入参构造格式不同，如果您没有使用官方sdk发起openapi调用，自行构造http请求时需注意以下事项：
1. 本接口使用multipart/form-data内容格式上传文本参数与文件，文件字段需传入filename文件名，并带扩展名（例如：content-disposition: form-data; name="file_content"; filename="example.png"），否则会提示图片类型为空。
2. 对于v2版本的协议，本接口的业务请求参数没有封装在biz_content字段中，直接平铺到请求的body中。
1. 本接口使用multipart/form-data内容格式上传文本参数与文件，文件字段需传入filename文件名，并带扩展名（例如：content-disposition: form-data; name="file_content"; filename="example.png"），否则会提示图片类型为空。
2. 对于v2版本的协议，本接口的业务请求参数没有封装在biz_content字段中，直接平铺到请求的body中。
公共请求参数
业务请求参数
scene｜业务场景描述必选string[1,64]
【描述】业务场景描述。
小程序订单中心场景固定为 sync_order。
【示例值】sync_order
file_content｜文件内容必选byte[][0,4194304]
【描述】文件二进制字节流，最大为4m。
小程序订单中心场景中，商品图片宽度必须大于 750 px，宽高比建议 4:3 - 1:1 之间，且该场景下仅支持 png、jpg 格式，不支持其他格式图片。
【示例值】-
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.merchant.item.file.upload&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'file_content=@/home/admin/test.jpg' \
-f 'scene=sync_order' 说明：本示例仅供参考。
公共响应参数
业务响应参数
material_id｜素材id必选string(256)
【描述】文件在商品中心的素材标识（素材id长期有效）
【示例值】2019010100502200000000000001
material_key｜素材标示必选string(255)
【描述】文件在商品中心的素材标示，创建/更新商品时使用
【示例值】a*bjxmryfobciaaaggggaaaabjaqwwww
响应示例
正常示例
异常示例
{
"alipay_merchant_item_file_upload_response": {
"code": "10000",
"msg": "success",
"material_id": "2019010100502200000000000001",
"material_key": "a*bjxmryfobciaaaggggaaaabjaqwwww"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| argument_illegal | 参数不合法 | 检查入参 |
| argument_null | 参数对象为空 | 检查入 |
| db_error | 数据库操作异常 | 1.业务重试 2.联系凯发app官方网站的技术支持 |
| info_sec_error | infosec 校验不通过 | infosec校验不通过，请不要使用敏感图片 |