獲取微信公眾平臺的素材列表

2020-08-31 10:13 更新

獲取素材列表

微信素材

在新增了永久素材后,開發(fā)者可以分類型獲取永久素材的列表。

請注意:

1、獲取永久素材的列表,也包含公眾號在公眾平臺官網(wǎng)素材管理模塊中新建的圖文消息、語音、視頻等素材 2、臨時素材無法通過本接口獲取 3、調(diào)用該接口需https協(xié)議

接口調(diào)用請求說明

http請求方式: POST https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN

調(diào)用示例

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

參數(shù)說明

參數(shù)是否必須說明
type素材的類型,圖片(image)、視頻(video)、語音 (voice)、圖文(news)
offset從全部素材的該偏移位置開始返回,0表示從第一個素材 返回
count返回素材的數(shù)量,取值在1到20之間

返回說明

永久圖文消息素材列表的響應(yīng)如下:

{
   "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結(jié)構(gòu)
  ]
}

其他類型(圖片、語音、視頻)的返回如下:

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

返回參數(shù)說明

參數(shù)描述
total_count該類型的素材的總數(shù)
item_count本次調(diào)用獲取的素材的數(shù)量
title圖文消息的標題
thumb_media_id圖文消息的封面圖片素材id(必須是永久mediaID)
show_cover_pic是否顯示封面,0為false,即不顯示,1為true,即顯示
author作者
digest圖文消息的摘要,僅有單圖文消息才有摘要,多圖文此處為空
content圖文消息的具體內(nèi)容,支持HTML標簽,必須少于2萬字符,小于1M,且此處會去除JS
url圖文頁的URL,或者,當獲取的列表是圖片素材列表時,該字段是圖片的URL
content_source_url圖文消息的原文地址,即點擊“閱讀原文”后的URL
update_time這篇圖文消息素材的最后更新時間
name文件名稱

錯誤情況下的返回JSON數(shù)據(jù)包示例如下(示例為無效媒體類型錯誤):

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


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號