添加公众号订阅

POST

/v1/subscriptions

仅接受 mp.weixin.qq.com 的文章链接。该操作会扣除积分，调用前应取得用户确认。
返回 processing 表示系统正在处理，并非失败。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "articleUrl": "https://mp.weixin.qq.com/s/example"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.weixinzs.org/api/v1/subscriptions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "articleUrl": "https://mp.weixin.qq.com/s/example"
}'

返回响应

🟢201

application/json

添加成功

Bodyapplication/json

示例

{
    "success": true,
    "subscription": {
        "id": "10001",
        "mpAccountId": "20001",
        "status": "processing",
        "firstFollowedAt": "2019-08-24T14:15:22.123Z",
        "lastFollowedAt": "2019-08-24T14:15:22.123Z",
        "unfollowedAt": "2019-08-24T14:15:22.123Z",
        "createdAt": "2019-08-24T14:15:22.123Z",
        "updatedAt": "2019-08-24T14:15:22.123Z",
        "account": {
            "id": "string",
            "username": "string",
            "alias": "string",
            "nickname": "string",
            "avatarUrl": "http://example.com"
        }
    }
}

🟠409

🟠400BadRequest

🟠401SkillUnauthorized

修改于 2026-08-29 03:25:31

查询全部订阅

取消公众号订阅