推送说明

说明

文章数据推送由我方发起 HTTP 请求，接收方（您）来提供 HTTP server 接收请求。

请求的 data、method 以及规则请见下文。

推送方式

• 推送通过 HTTP POST 请求进行，请先配置用于接收请求的 API 地址。
• 仅支持 Bearer Token 的鉴权方式，会在 Authorization 头中携带，如需鉴权，请分配 Token 给我方。
• 请求的 Content-Type 为 application/json
• 重试机制: 若首次推送失败，最多重试 3 次，分别在 5、10、20 分钟后重试。其中一次重试成功后，之后的重试不会再发起

如何设置接收的 API 地址及 Bearer Token

鉴权方式

仅支持 Bearer Token 的鉴权方式，系统会在推送请求的 HTTP 头中携带认证信息：

Authorization: Bearer {your_token}

• Token 由接收方（您）提供
• 请确保您的服务能够验证此 Token 的有效性

若您不需要鉴权，可不进行设置。 如何设置接收的 API 地址及 Bearer Token

请求参数

参数名称	参数类型	是否必传	默认值	描述
articleId	String	✅		文章ID，唯一标识符
mpId	Integer	✅		公众号ID，正整数
mpIdB64	String	✅		公众号ID Base64编码，用于URL安全传输
mpName	String	✅		公众号名称
articleMsgId	Integer	✅		文章消息ID，正整数
articleIdx	Integer	✅		文章索引，非负整数
articleSn	String	✅		文章签名，用于生成备用链接
title	String	✅		文章标题
coverImg	String	✅	空字符串	封面图URL
description	String	✅	空字符串	文章描述
publishedAt	Integer	✅		发布时间戳(秒级时间戳)
url	String	✅		文章链接
url2	String	✅		备用文章链接

请求参数示例

{
  "articleId": "2247484078_1",
  "mpId": 2247484078,
  "mpIdB64": "MjI0NzQ4NDA3OA==",
  "mpName": "示例公众号",
  "articleMsgId": 2247484078,
  "articleIdx": 1,
  "articleSn": "abc123def456",
  "title": "示例文章标题",
  "coverImg": "https://example.com/cover.jpg",
  "description": "这是一篇示例文章的描述",
  "publishedAt": 1640995200,
  "url": "https://mp.weixin.qq.com/s/2247484078_1",
  "url2": "https://mp.weixin.qq.com/s?__biz=2247484078&mid=2247484078&idx=1&sn=abc123def456"
}

响应处理

成功响应

• 状态码: 20x
• 推送成功，无需特殊处理

失败响应

• 客户端错误，系统会按重试机制进行重试