上传临时素材 - Developer OpenAPI

素材上传得到media_id，该media_id仅三天内有效
media_id在同一企业内应用之间可以共享

POST的请求包中，form-data中媒体文件标识，应包含有 filename、filelength、content-type等信息

filename标识文件展示的名称。比如，使用该media_id发消息时，展示的文件名由该字段控制

请求示例：

POST https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=accesstoken001&type=file HTTP/1.1Content-Type: multipart/form-data; boundary=-------------------------acebdf13572468Content-Length: 220---------------------------acebdf13572468Content-Disposition: form-data; name="media";filename="wework.txt"; filelength=6Content-Type: application/octet-streammytext---------------------------acebdf13572468--

上传的媒体文件限制
所有文件size必须大于5个字节

图片（image）：2MB，支持JPG,PNG格式
语音（voice）：2MB，播放长度不超过60s，仅支持AMR格式
视频（video）：10MB，支持MP4格式
普通文件（file）：20MB

文档ID: 10112
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90253
https://open.work.weixin.qq.com/api/doc/90001/90389
https://open.work.weixin.qq.com/api/doc/90002/90871

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

type

string

必需

媒体文件类型，分别有图片（image）、视频（video）、普通文件（file）

示例值:

Body 参数multipart/form-data

filename

string

必需

示例值:

filename标识文件展示的名称。比如，使用该media_id发消息时，展示的文件名由该字段控制

filelength

string

必需

name

string

必需

示例值:

使用multipart/form-data POST上传文件，文件标识名为”media”

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

type

string

必需

媒体文件类型，分别有图片（image）、语音（voice）、视频（video），普通文件(file)

media_id

string

必需

媒体文件上传后获取的唯一标识，3天内有效

created_at

string

媒体文件上传时间戳

必需

示例

{
    "errcode": 0,
    "errmsg": "string",
    "type": "string",
    "media_id": "string",
    "created_at": "string"
}