新增临时素材
调用本接口可以把媒体文件上传到微信服务器。目前仅支持图片。用于发送客服消息或被动回复用户消息。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。
请求地址
POST https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token | String | 是 | 第三方平台接口调用令牌authorizer_access_token | |
type | string | 是 | 文件类型,当前仅支持"imgae",表示图片; | |
media | FormData | 是 | form-data 中媒体文件标识,有filename、filelength、content-type等信息 |
调用示例
使用 CURL 命令,用 FORM 表单方式上传一个多媒体文件
curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"
返回值说明
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
type | string | 文件类型 |
media_id | string | 媒体文件上传后,获取标识,3天内有效。 |
created_at | number | 媒体文件上传时间戳 |
返回示例
{
"errcode": 0,
"errmsg": "ok",
"type": "image",
"media_id": "MEDIA_ID",
"created_at": "xxx"
}
返回码说明
返回码 | 说明 |
---|---|
0 | 成功 |
40004 | 无效媒体文件类型 |
其他错误码 | 请查看全局错误码 |