# 上传资料
可通过该接口上传文件,用于下单后传给商家进行定制商品发货
# 注意事项:
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)无效,无法下载文件 |