新增临时素材

调用本接口可以把媒体文件上传到微信服务器。目前仅支持图片。用于发送客服消息或被动回复用户消息。使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

请求地址

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 无效媒体文件类型
其他错误码 请查看全局错误码