weixin.item_search

公共参数

请求地址: https://api-gw-4.cn/weixin/item_search

请求参数

请求参数：q=连衣裙&

参数说明：q:关键词,没有其他参数

响应参数

Version: Date:

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw-4.cn/weixin/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=连衣裙&"

响应示例

异常示例

相关资料

错误码解释

API 工具

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

### 返回值

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

```json
{
  "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. **错误处理**：开发者在调用接口时应检查`errcode`和`errmsg`字段，以处理可能的错误情况。
3. **分页处理**：如果`item_count`小于`total_count`，则表示还有更多的素材未被返回，需要继续调用接口并传递适当的分页参数来获取剩余素材。
4. **数据更新**：公众号内的素材列表会随着时间的推移而发生变化，如文章被删除、修改等，因此获取的数据可能不是最新的。
5. **接口变更**：微信公众平台的接口和返回数据可能会随着时间进行变更或升级，开发者需要定期检查并更新自己的代码以适应新的变化。