FindBLOG 为注册用户提供个人订阅信息流 JSON 接口，便于用户将自己在平台订阅的博客内容，通过标准化 JSON 格式同步至外部站点，实现**“朋友圈”式聚合展示**。
一、开启方式
- 登录 FindBLOG 用户后台
- 进入「博友圈」模块
- 点击「开启服务」
- 点击「生成 JSON 地址」
- 系统将分配一个专属地址，格式如下：https://www.findblog.net/{your_token}.json该地址为只读公开链接，请勿泄露 Token，避免被他人滥用额度。
二、接口机制与更新策略
| 项目 | 说明 |
|---|---|
| 生成频率 | 每 4 小时自动生成一次（系统级定时任务） |
| 访问限制 | 每日最多 30 次请求（按 IP + Token 组合计数） |
| 最大条目数 | 每次返回最多 60 篇文章（按发布时间倒序） |
| 建议用法 | 同步到本地，而非前端直接跨域调用 |
⚠️ 重要提示：
本平台为公益服务，服务器资源有限。为避免高频拉取导致系统负载过高，强烈建议用户采用“定时拉取 + 本地缓存”机制，例如每 6 小时同步一次，完全满足日常展示需求。
三、使用方式（推荐实践）
1. 同步到本地（推荐）
使用 curl 或 wget 定时拉取 JSON 文件至您的网站目录：
bash
复制
# 每 4 小时同步一次（crontab 示例）0 */4 * * * curl-s https://www.findblog.net/your_token.json -o /www/wwwroot/yoursite/data/friends.json
然后在页面中读取本地文件并渲染（如 PHP、Node.js、静态生成器等）。
2. 插件支持（零代码方案）
我们提供官方插件，支持以下平台：
- WordPress
- Typecho
安装步骤：
- 下载插件（后台提供）
- 上传至 /wp-content/plugins/ 或 /usr/plugins/
- 在插件设置页填写您的 JSON 地址（https://www.findblog.net/your_token.json）
- 启用后，可通过短代码或区块在任意页面展示「博友朋友圈」
插件内置缓存机制，默认 4 小时更新一次，不额外消耗 API 调用次数。
3. 静态博客适配
对于 Hexo、Hugo、VitePress 等静态博客，可在构建阶段通过脚本拉取 JSON 并生成为静态页面或组件，例如：
JavaScript
复制
// 示例：在 Hexo 的 generate 阶段使用const axios =require('axios');const fs =require('fs');axios.get('https://www.findblog.net/your_token.json').then(res=>{ fs.writeFileSync('source/_data/friends.json',JSON.stringify(res.data,null,2));});
随后在模板中读取 friends.json 渲染朋友圈列表。
四、JSON 数据结构说明
以下为接口返回的标准格式（实际字段以后台生成为准）：
JSON
复制
{"updated_at":"2025-10-21 14:00:02","next_update":"2025-10-21 18:00:02","count":60,"items":[{"feed_icon":"https://favicon.im/synyan.cn","feed_name":"旅行漫记","groups":"博友订阅","title":"长广溪悦溪酒店","url":"https://synyan.cn/104914","summary":"惭愧，都快月底了十一假期出行游记还没写完，趁最后一篇图少，今晚赶工把图都发了。假期到了10月8日，所有人都收心了，但我又不甘趴在家中，于是去长广溪湿地公园颇具...","time":"2025-10-21 00:06"}// ... 更多条目]}
字段说明：
| 字段名 | 类型 | 说明 |
|---|---|---|
| updated_at | string | 本次 JSON 文件生成时间（北京时间） |
| next_update | string | 预计下次更新时间（可用于显示“下次刷新倒计时”） |
| count | int | 当前返回的文章数量（≤60） |
| items | array | 文章列表，按发布时间倒序排列 |
| feed_icon | string | 站点 favicon 图标（通过第三方服务获取） |
| feed_name | string | 订阅源名称（用户在 FindBLOG 中自定义） |
| groups | string | 所属分组（如“博友订阅”、“技术博客”等） |
| title | string | 文章标题 |
| url | string | 原文链接 |
| summary | string | 文章摘要（前 100~150 字） |
| time | string | 文章发布时间（格式：YYYY-MM-DD HH:mm） |
五、注意事项与合规使用
- 禁止高频轮询：超过每日 30 次将返回 429 Too Many Requests，频繁超限可能被封禁 Token。
- 禁止商用爬取：本接口仅服务于个人博客展示，禁止批量抓取用于商业化聚合、AI 训练等用途。
- 内容版权：所有文章版权归原作者所有，引用时请保留原文链接与作者信息。
- 数据一致性：由于源站更新延迟或 RSS 异常，部分文章时间可能存在偏差，我们正在优化清洗逻辑。
- 失效处理：若 Token 长期未使用（如 90 天无请求），系统可能暂停生成，需重新激活。
让我们共同维护一个轻量、开放、可持续的博客朋友圈生态。
无需后端，也能拥有属于自己的「博友宇宙」。
无需后端，也能拥有属于自己的「博友宇宙」。
—— FindBLOG 团队 2025年10月