# 上传资料
可通过该接口上传文件,用于下单后传给商家进行定制商品发货
# 注意事项:
1)文件最大支持50M 2)添加HTTP头Content-Type: multipart/form-data
# 接口调用请求说明
http请求方式: POST
https://api.weixin.qq.com/channels/ec/open/upload?access_token=ACCESS_TOKEN
# 请求示例
两种上传方式:
1)上传文件二进制(支持<10M大小的文件)
参数名 | 类型 | 是否必填 | 说明 | 备注 |
---|---|---|---|---|
openid | string | 是 | 上传资料的用户openid | |
file | 文件 | 是 | 上传的资料文件内容 | 支持图片、CAD、3dMax、压缩包、PDF、Excel、Word等 |
upload_type | int | 是 | 上传方式, 传0 |
请求示例:
curl -F file=@test.png
"https://api.weixin.qq.com/channels/ec/open/upload?access_token=ACCESS_TOKEN&openid=xxxx&upload_type=0"
2)以文件url上传(支持<50M大小的文件)
参数名 | 类型 | 是否必填 | 说明 | 备注 |
---|---|---|---|---|
openid | string | 是 | 上传资料的用户openid | |
file_url | 文件 | 是 | 上传文件的url | 支持图片、CAD、3dMax、压缩包、PDF,Excel、Word等 |
upload_type | int | 是 | 上传方式, 传1 |
请求示例:
curl -X POSt -d'{"openid":"xxx","file_url":"xxx"}'
"https://api.weixin.qq.com/channels/ec/open/upload?access_token=ACCESS_TOKEN&upload_type=1"
# 支持上传的文件格式:
类型 | 格式 | Content-Type |
---|---|---|
图片 | .bmp | image/bmp |
图片 | .jpg | image/jpeg,image/jpg |
图片 | .jpeg | image/jpeg,image/jpg |
图片 | .png | image/png,application/x-png |
图片 | .svg | text/xml |
图片 | .webp | image/webp |
CAD | .dwg | application/acad |
CAD | .dxf | application/dxf |
CAD | .dgn | image/vnd.dgn |
CAD | .stl | model/stl,application/sla |
3DMax | .max | application/octet-stream |
3DMax | .3d | application/octet-stream |
3DMax | .fbx | application/octet-stream |
3DMax | .abc | application/octet-stream |
3DMax | .dae | application/octet-stream |
压缩包 | .zip | application/zip |
压缩包 | .rar | application/x-rar-compressed |
压缩包 | .7z | application/x-7z-compressed |
压缩包 | .gz | application/gzip,application/x-gzip |
普通文件 | .docx | application/vnd.openxmlformats-officedocument.wordprocessingml.documen |
普通文件 | .doc | application/msword |
普通文件 | .xls | application/vnd.ms-excel |
普通文件 | .xlsx | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
普通文件 | .csv | text/csv |
普通文件 | application/pdf |
注:压缩包中只能包含支持的文件类型
# 回包示例
{
"errcode":0,
"errmsg":"成功",
"media_id":"892AERDPD2323"
}
# 回包参数说明
参数 | 类型 | 描述 |
---|---|---|
errcode | int | 错误码,0-成功,其他-失败 |
errmsg | string | 错误信息 |
media_id | string | 文件media_id |
# 错误码
错误码 | 描述 |
---|---|
-1 | 系统失败,请重试 |
0 | 成功 |
10001 | 无效的mediaid |
10002 | 无效的mediaid |
10003 | 文件正在上传中,请等待 |
10004 | 上传文件存在风险,请重新上传 |
10005 | 订单已取消,禁止下载文件 |
10006 | 订单已结束,禁止下载文件 |
10007 | 上传文件格式不支持 |
10008 | 上传文件的大小超过最大值 |
10009 | 下载文件次数超过日上限,请第二天再试 |
10010 | 上传url(file_url)无效,无法下载文件 |