微信公众号:如何根据关键词取文章列表 API 返回值说明?

42 阅读3分钟

微信公众号根据关键词获取文章列表的API通常指的是微信公众平台的“素材管理”接口中的“获取素材列表”功能。通过这个接口,开发者可以获取公众号已上传的文章素材列表,包括图文消息、视频、音频等。以下是API返回值的一般说明:

返回值

**注:**以下返回值结构是基于微信公众平台官方文档的通用结构,具体细节和字段可能会随着平台更新而发生变化,请以最新官方文档为准。

{
  "errcode": 0,
  "errmsg": "ok",
  "total_count": 100,  // 符合条件的素材总数
  "item_count": 10,    // 本次调用返回的素材数量
  "items": [
    {
      "media_id": "MEDIA_ID",  // 素材的media_id
      "title": "TITLE",        // 素材的标题
      "thumb_media_id": "THUMB_MEDIA_ID",  // 素材缩略图的media_id
      "author": "AUTHOR",      // 作者
      "digest": "DIGEST",      // 摘要
      "show_cover_pic": 1,     // 是否显示封面,0为不显示,1为显示
      "content_type": "1",     // 素材类型,1为图文消息,2为图片,3为视频,4为音频
      "content": {
        // 图文消息的具体内容,当content_type为1时返回
        "news_item": [
          {
            "title": "TITLE",
            "description": "DESCRIPTION",
            "url": "URL",
            "picurl": "PIC_URL"
          },
          // ... 其他图文消息项
        ]
      },
      "create_time": "1380000000"  // 素材创建时间
    },
    // ... 其他素材项
  ]
}

返回值字段说明

  • errcode: 错误码,0表示请求成功,非0值表示请求失败。
  • errmsg: 错误信息,当errcode不为0时返回具体的错误信息。
  • total_count: 符合条件的素材总数,表示当前关键词下所有符合条件的素材数量。
  • item_count: 本次调用返回的素材数量,表示本次请求返回的文章列表中的文章数量。
  • items: 文章列表,包含多个文章对象。
    • media_id: 素材的唯一标识,可用于发送消息等接口。
    • title: 素材的标题。
    • thumb_media_id: 素材缩略图的media_id,可以用于获取缩略图链接。
    • author: 作者。
    • digest: 摘要或简介。
    • show_cover_pic: 是否显示封面图片,1表示显示,0表示不显示。
    • content_type: 素材的类型,如1为图文消息,2为图片,3为视频,4为音频。
    • content: 具体内容,当content_type为1时,该字段包含图文消息的具体内容。
      • news_item: 图文消息项列表,包含多个图文消息对象。
        • title: 图文消息的标题。
        • description: 图文消息的描述或摘要。
        • url: 图文消息的链接地址。
        • picurl: 图文消息的封面图片链接。
    • create_time: 素材的创建时间,以Unix时间戳形式表示。

注意事项

  1. 调用频率限制:根据公众平台的限制,开发者调用该接口的频率可能有限制,请遵守相关规定。
  2. 错误处理:开发者在调用接口时应检查errcodeerrmsg字段,以处理可能的错误情况。
  3. 分页处理:如果item_count小于total_count,则表示还有更多的素材未被返回,需要继续调用接口并传递适当的分页参数来获取剩余素材。
  4. 数据更新:公众号内的素材列表会随着时间的推移而发生变化,如文章被删除、修改等,因此获取的数据可能不是最新的。
  5. 接口变更:微信公众平台的接口和返回数据可能会随着时间进行变更或升级,开发者需要定期检查并更新自己的代码以适应新的变化。

确保在实际开发中查阅最新的微信公众平台官方文档,以获取最准确的信息和接口使用指南。