该接口将文件上传到数据专区临时存储,得到media_id。
media_id 仅三天内有效
media_id 不能跨企业使用,也不能跨应用使用
media_id 仅可以用于数据专区接口或SDK
应用需具备「数据与智能专区」权限
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/chatdata/upload_media?access_token=ACCESS_TOKEN&type=TYPE
使用multipart/form-data POST上传文件, 文件标识名为"media"
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
type | 是 | 文件类型,目前仅支持普通文件:file |
POST的请求包中,form-data中文件标识,应包含有 filename、filelength、content-type等信息
filename标识文件展示的名称。比如,下载文件时,展示的文件名由该字段控制
请求示例:
POST https://qyapi.weixin.qq.com/cgi-bin/chatdata/upload_media?access_token=accesstoken001&type=file HTTP/1.1
Content-Type: multipart/form-data; boundary=-------------------------acebdf13572468
Content-Length: 220
---------------------------acebdf13572468
Content-Disposition: form-data; name="media";filename="wework.txt"; filelength=6
Content-Type: application/octet-stream
mytext
---------------------------acebdf13572468--
返回数据:
{
"errcode": 0,
"errmsg": "",
"type": "file",
"media_id": "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
"created_at": "1380000000"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
type | 文件类型,目前仅支持普通文件:file |
media_id | 文件上传后获取的唯一标识,3天内有效 |
created_at | 文件上传时间戳 |
所有文件size必须介于:6B~30MB