Docs.badge

开发者接入

生成 Token，并通过 API 拉取你已订阅的消息。

如果你希望把已订阅的公众号消息同步到自己的系统，可以使用开发者 API。

适合哪些场景

同步到内部看板或后台
推送到飞书、企业微信或机器人
写入知识库、向量库或 AI 工作流
做定时拉取和自动分类

接入前提

在使用 API 前，请先完成两件事：

已在网页端成功订阅至少一个公众号
已在网页端创建全站通用 API Key

如何创建 API Key

点击打开 API Key 页面

登录系统
打开个人中心菜单里的“API Key 管理”，或进入独立的 API Key 页面
创建一个新的 API Key
复制并妥善保存 Key

请注意：API Key 只会在创建时完整展示一次，建议立即保存。这个 Key 也可以用于 MD 文件导入 API。

请求地址

GET https://api.fafafa.ai/api/v1/wechat/messages

上面已经是系统按当前生产环境自动拼出的完整请求地址，你可以直接复制使用。域名部分取自系统环境变量 WORKER_PUBLIC_BASE_URL，再自动拼接 /api/v1/wechat/messages。

鉴权方式

使用 Bearer API Key：

Authorization: Bearer YOUR_API_KEY

常用参数

参数	说明
`page`	页码，适合首次全量拉取
`pageSize`	每页条数
`since`	用于增量拉取某个时间之后的新消息

示例请求

curl 'https://api.fafafa.ai/api/v1/wechat/messages?page=1&pageSize=20' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'

推荐接入方式

首次同步

先按分页拉取全部可见消息，完成初始化。

增量同步

保存上一次成功拉取的时间，之后使用 since 只拉取新增消息。

幂等处理

如果你会把消息写入自己的系统，建议按文章唯一标识做去重，避免重复处理。

建议由网页完成的操作

以下操作建议继续在网页端完成：

添加订阅
取消订阅
查看套餐与额度
创建、删除和轮换 API Key

API 更适合做“消费消息”，而不是做完整管理后台。