除了3天就会失效的临时素材外，开发者有时需要永久保存一些素材。本节内容如下：

1. 新增永久素材
   1.1 新增永久图文素材
   1.2 上传图文消息内的图片获取URL
   1.3 新增其他类型永久素材
2. 获取永久素材
3. 删除永久素材
4. 获取素材总数
5. 获取素材列表

1. 新增永久素材

通过本接口新增永久素材。请注意：

1. 新增的永久素材也可以在公众平台官网素材管理模块中看到
2. 永久素材的数量是有上限的，请谨慎新增。图文消息素材和图片素材的上限为5000，其他类型为1000
3. 素材的格式大小等要求与公众平台官网一致。具体是，图片大小不超过2M，支持bmp/png/jpeg/jpg/gif格式，语音大小不超过5M，长度不超过60秒，支持mp3/wma/wav/amr格式

1.1 新增永久图文素材

http请求方式: POST，http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy

Data参数JSON示例

{
  "articles": [{
       "title": TITLE,
       "thumb_media_id": THUMB_MEDIA_ID,
       "author": AUTHOR,
       "digest": DIGEST,
       "show_cover_pic": SHOW_COVER_PIC(0 / 1),
       "content": CONTENT,
       "content_source_url": CONTENT_SOURCE_URL
    },
    //若新增的是多图文素材，则此处应还有几段articles结构
 ]
}

返回说明

{
  "media_id":MEDIA_ID
}

返回的即为新增的图文消息素材的media_id。
请注意，在图文消息的具体内容中，将过滤外部的图片链接，开发者可以通过下述接口上传图片得到URL，放到图文内容中使用。

1.2 上传图文消息内的图片获取URL

请注意，本接口所上传的图片不占用公众号的素材库中图片数量的5000个的限制。图片仅支持jpg/png格式，大小必须在1MB以下。

接口调用请求说明

http请求方式: POST，http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=uploadimg
调用示例（使用curl命令，用FORM表单方式上传一个图片）：
curl 'http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=uploadimg'
    -F media=@test.jpg -F ConnectKey=CONNECTKEY -F access_token=ACCESS_TOKEN

返回说明

正常情况下的返回结果为：

{
    "url":  "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWa/0"
}

其中url就是上传图片的URL，可用于后续群发中，放置到图文消息中。

1.3 新增其他类型永久素材

通过POST表单来调用接口，表单id为media，包含需要上传的素材内容，有filename、filelength、content-type等信息。请注意：图片素材将进入公众平台官网素材管理模块中的默认分组。

接口调用请求说明

http请求方式: POST，http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=add_material
调用示例（使用curl命令，用FORM表单方式上传一个多媒体文件）：
curl 'http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=add_material'
    -F media=@test.jpg -F ConnectKey=CONNECTKEY -F access_token=ACCESS_TOKEN -F type=TYPE

返回说明

{
 "media_id":MEDIA_ID,
 "url":URL
}

错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）

{"errcode":40007,"errmsg":"invalid media_id"}

新增永久视频素材需特别注意
在上传视频素材时需要POST另一个表单，id为description，包含素材的描述信息，内容格式为JSON，格式如下：

{
 "title":VIDEO_TITLE,
 "introduction":INTRODUCTION
}

新增永久视频素材的调用示例：

curl 'http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=add_material'
    -F media=@test.mov -F ConnectKey=CONNECTKEY -F access_token=ACCESS_TOKEN -F type=video
    -F description='{"title":VIDEO_TITLE, "introduction":INTRODUCTION}' 

参数说明

2. 获取永久素材

在新增了永久素材后，开发者可以根据media_id来获取永久素材，需要时也可保存到本地。

1. 获取永久素材也可以获取公众号在公众平台官网素材管理模块中新建的图文消息、图片、语音、视频等素材（但需要先通过获取素材列表来获知素材的media_id）
2. 临时素材无法通过本接口获取

接口调用请求说明

http请求方式: POST，http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy

Data参数JSON示例

{
"media_id":MEDIA_ID
}

返回说明

如果请求的素材为图文消息，则响应如下：

{
"news_item":
[
    {
    "title":TITLE,
    "thumb_media_id"::THUMB_MEDIA_ID,
    "show_cover_pic":SHOW_COVER_PIC(0/1),
    "author":AUTHOR,
    "digest":DIGEST,
    "content":CONTENT,
    "url":URL,
    "content_source_url":CONTENT_SOURCE_URL
    },
    //多图文消息有多篇文章
 ]
}

如果返回的是视频消息素材，则内容如下：

{
 "title":TITLE,
 "description":DESCRIPTION,
 "down_url":DOWN_URL,
}

其他类型的素材消息，则响应的直接为素材的内容，开发者可以自行保存为文件

错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）：

{"errcode":40007,"errmsg":"invalid media_id"}

3. 删除永久素材

在新增了永久素材后，开发者可以根据本接口来删除不再需要的永久素材，节省空间。

1. 请谨慎操作本接口，因为它可以删除公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材（但需要先通过获取素材列表来获知素材的media_id）
2. 临时素材无法通过本接口删除

接口调用请求说明

http请求方式: POST，http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy

Data参数JSON示例

{
"media_id":MEDIA_ID
}

返回说明

{
   "errcode":ERRCODE,
   "errmsg":ERRMSG
}

正常情况下调用成功时，errcode将为0。

3. 修改永久图文素材

开发者可以通过本接口对永久图文素材进行修改。

1. 也可以在公众平台官网素材管理模块中保存的图文消息（永久图文素材）

接口调用请求说明

http请求方式: POST，http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy

Data参数JSON示例

{
 "media_id":MEDIA_ID,
 "index":INDEX,
 "articles": {
      "title": TITLE,
      "thumb_media_id": THUMB_MEDIA_ID,
      "author": AUTHOR,
      "digest": DIGEST,
      "show_cover_pic": SHOW_COVER_PIC(0 / 1),
      "content": CONTENT,
      "content_source_url": CONTENT_SOURCE_URL
   }
}

返回说明

{
   "errcode":ERRCODE,
   "errmsg":ERRMSG
}

正常情况下调用成功时，errcode将为0。

4. 获取素材总数

开发者可以根据本接口来获取永久素材的列表，需要时也可保存到本地。

1. 永久素材的总数，也会计算公众平台官网素材管理中的素材
2. 图片和图文消息素材（包括单图文和多图文）的总数上限为5000，其他素材的总数上限为1000

接口调用请求说明

http请求方式: POST，http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy

返回说明

{
 "voice_count":COUNT,
 "video_count":COUNT,
 "image_count":COUNT,
 "news_count":COUNT
}

错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）：

{"errcode":-1,"errmsg":"system error"}

5. 获取素材列表

在新增了永久素材后，开发者可以分类型获取永久素材的列表。

1. 获取永久素材的列表，也包含公众号在公众平台官网素材管理模块中新建的图文消息、语音、视频等素材
2. 临时素材无法通过本接口获取

接口调用请求说明

http请求方式: POST，http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=proxy

Data参数JSON示例

{
   "type":TYPE,
   "offset":OFFSET,
   "count":COUNT
}

返回说明

永久图文消息素材列表的响应如下：

{
  "total_count": TOTAL_COUNT,
  "item_count": ITEM_COUNT,
  "item": [{
      "media_id": MEDIA_ID,
      "content": {
          "news_item": [{
              "title": TITLE,
              "thumb_media_id": THUMB_MEDIA_ID,
              "show_cover_pic": SHOW_COVER_PIC(0 / 1),
              "author": AUTHOR,
              "digest": DIGEST,
              "content": CONTENT,
              "url": URL,
              "content_source_url": CONTETN_SOURCE_URL
          },
          //多图文消息会在此处有多篇文章
          ]
       },
       "update_time": UPDATE_TIME
   },
   //可能有多个图文消息item结构
 ]
}

其他类型（图片、语音、视频）的返回如下：

{
  "total_count": TOTAL_COUNT,
  "item_count": ITEM_COUNT,
  "item": [{
      "media_id": MEDIA_ID,
      "name": NAME,
      "update_time": UPDATE_TIME,
      "url":URL
  },
  //可能会有多个素材
  ]
}

错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）：

{"errcode":40007,"errmsg":"invalid media_id"}