FaFaFa.ai
幫助中心

開發者接入

生成 Token，並透過 API 拉取你已訂閱的消息。

如果你希望把已訂閱的公眾號消息同步到自己的系統，可以使用開發者 API。

適合哪些場景

  • 同步到內部看板或後台
  • 推送到飛書、企業微信或機器人
  • 寫入知識庫、向量庫或 AI 工作流
  • 做定時拉取和自動分類

接入前提

在使用 API 前，請先完成兩件事：

  1. 已在網頁端成功訂閱至少一個公眾號
  2. 已在網頁端建立全站通用 API Key

如何建立 API Key

點擊打開 API Key 頁面

  1. 登入系統
  2. 打開個人中心選單裡的「API Key 管理」，或進入獨立的 API Key 頁面
  3. 建立一個新的 API Key
  4. 複製並妥善保存 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 更適合做「消費消息」，而不是取代完整管理後台。