上传永久素材

来自企业号开发者接口文档
跳转至: 导航搜索

上传永久图文素材

用于上传图文消息素材,接口返回素材资源标识ID:media_id。media_id是可复用的,同一个media_id可用于消息的多次发送。使用永久图文素材ID发送消息参见:mpnews消息发送说明

  • 请求说明

Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/material/add_mpnews?access_token=ACCESS_TOKEN

  • 请求包结构体为:
{
    "mpnews":{
           "articles":[
            {
               "title": "Title01",
               "thumb_media_id": "2-G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
               "author": "zs",
               "content_source_url": "",
               "content": "Content001",
               "digest": "airticle01",
               "show_cover_pic": "0"
              },
             {
               "title": "Title02",
               "thumb_media_id": "2-G6nrLmr5EC3MMb_-zK1dDdzmd0p7",
               "author": "Author001",
               "content_source_url": "",
               "content": "Content002",
               "digest": "article02",
               "show_cover_pic": "0"
             },
           //此处有多篇文章
            ]
    },
}
  • 参数说明
参数 必须 说明
access_token 调用接口凭证
articles 图文消息,一个图文消息支持1到10个图文
title 图文消息的标题
thumb_media_id 图文消息缩略图的media_id, 可以在上传永久素材接口中获得
author 图文消息的作者
content_source_url 图文消息点击“阅读原文”之后的页面链接
content 图文消息的内容,支持html标签
digest 图文消息的描述
show_cover_pic 是否显示封面,1为显示,0为不显示。默认为0
  • 权限说明

所有管理组均可调用,素材归管理组所有。

  • 返回说明
{
   "errcode": "0",
   "errmsg": "ok",
   "media_id": "2-G6nrLmr5EC3MMfasdfb_-zK1dDdzmd0p7"
}
参数 说明
media_id 素材资源标识ID。最大长度为256字节


上传其他类型永久素材

用于上传图片、语音、视频等媒体资源文件以及普通文件(如doc,ppt),接口返回素材资源标识ID:media_id。media_id是可复用的,同一个media_id可用于消息的多次发送。

  • 请求说明

Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/material/add_material?type=TYPE&access_token=ACCESS_TOKEN

  • 参数说明
参数 必须 说明
access_token 调用接口凭证
type 媒体文件类型,分别有图片(image)、语音(voice)、视频(video),普通文件(file)
media form-data中媒体文件标识,有filename、filelength、content-type等信息
  • 权限说明

所有管理组均可调用。

  • 返回说明
{
   "errcode":0,
   "errmsg":"ok",
   "media_id": "2-G6nrLmr5EFSDC3MMfasdfb_-zK1dDdzmd0p7"
}
参数 说明
media_id 素材资源标识ID。最大长度为256字节
  • 上传永久素材限制

所有文件size必须大于5个字节

图片(image):2MB,支持JPG,PNG格式

语音(voice):2MB,播放长度不超过60s,支持AMR格式

视频(video):10MB,支持MP4格式

普通文件(file):20MB

整个企业图文消息素材和图片素材数目的上限为5000,其他类型为1000

超出素材数量限制返回错误码45028