尧图网站建设 
Folo 开放API第三方集成实战3步拿到密钥、发出第一个请求并看懂返回结果【免费下载链接】follow Folo is the AI RSS Reader项目地址: https://gitcode.com/GitHub_Trending/fol/followFolo 是一个 AI RSS 阅读器它把订阅源、精选列表和内容时间线都放在服务端统一管理而它的开放 API默认入口在 apps/cli/src/client.ts 里写明的api.folo.is就是把这些能力开放出来任何脚本、机器人或你自己的小应用都能通过一组 REST 接口读写订阅、拉取时间线、批量标记已读。简单说你不用再对着 App 点点点一条命令或一个 fetch 就能把 Folo 变成你工作流里的数据源。 先说清楚什么情况下你会用到 Folo API想象两个场景。一个是运营同学老周她每天要盯十几个技术订阅源希望每天早上 8 点自动把昨日未读文章喂给 AI 总结推到工作群。手动点根本做不到定时但如果未读数、文章列表都能用接口拿这事就是一个定时脚本的事。另一个是做 AI Agent 的人想让 Agent 能替用户查我订阅了什么有哪些没读的甚至帮用户增删订阅。Folo 官方 CLI 本身就是一份现成的 API 调用范例连 Agent 用的说明书都写好了可以直接对照着接。所以 Folo 开放 API 解决的核心问题是把人肉在 App 里操作变成程序按接口协议自动操作。 三步上手从拿到密钥到看懂第一个返回第一步拿到你的 API 密钥session tokenFolo API 用的是 Bearer Token 认证也就是你的 session token。最省事的方式是用官方 CLI 走一遍浏览器登录npx --yes foloclilatest login这条命令会拉起浏览器完成 Folo 账号登录通过本地一次性回调把 token 换回来并写进本地配置整个过程约 3 分钟超时保护实现细节可以看 apps/cli/src/browser-login.ts。如果是在服务器上跑没有浏览器就手动指定 token或者用环境变量npx --yes foloclilatest login --token 你的token export FOLO_TOKEN你的token第二步发出第一个真实请求登录成功后发个请求验证一下。直接调 session 检查接口就能看懂整个认证模式——Authorization头里放 Bearer token再带上对应的 cookieconst res await fetch(https://api.folo.is/better-auth/get-session, { headers: { Authorization: Bearer ${token}, Cookie: __Secure-better-auth.session_token${token}, }, }); const session await res.json();返回里能看到你的用户信息、角色、订阅配额feedSubscriptionLimit 这些字段这等于顺手完成了权限自检。第三步看懂返回结果学会翻页Folo 的接口返回是统一的 JSON 信封结构成功是{ ok: true, data: {...} }失败是{ ok: false, error: { code, message } }这个约定在 apps/cli/skill.md 里写得很清楚写自动化时照着解析就行。时间线这类列表接口额外返回entries、nextCursor、hasNext三个字段拿到nextCursor再传回--cursor就能翻下一页循环到hasNext为false就到底了。 进阶玩法三个最值钱的集成场景场景一定时机器人每天自动消化未读组合unread counttimeline --unread-onlyentry mark-read三条命令就是一个完整的拉未读→处理→标记闭环npx --yes foloclilatest timeline --unread-only --limit 20 npx --yes foloclilatest entry mark-all-read --view articles老周那个喂给 AI 总结的机器人骨架就是这两条命令加一层定时触发。场景二订阅迁移与备份opml export --output backup.opml一条命令导出全部订阅opml import导回来。换平台、备份、给新设备播种订阅源都不用手点。场景三自己部署时如何接收外部回调如果你要把 Folo 的自部署版接进自己的发布流程可以研究一下 api/vercel_webhook.ts它展示了 Folo 团队自己是怎么处理外部 webhook 的——HMAC-SHA1 校验请求体签名x-vercel-signature头、密钥缺失时返回 400、签名不匹配返回 403。自己写集成回调时照抄这套校验姿势安全性就有了基本盘。 避坑清单高频报错对照排查报错 / 现象大概率原因怎么修UNAUTHORIZED/ 401token 过期、复制不完整或漏了 cookie 头重新login服务端场景检查FOLO_TOKEN是否完整INVALID_ARGUMENT参数不合法比如--feed、--list、--category同时传了跑一下命令 --help看接受哪些参数4xx / 5xx自部署时--api-url指向错环境加--verbose看完整请求和状态码再定位JSON 解析失败请求体不是合法 JSON或缺Content-Type: application/json打印原始响应体先JSON.parse确认格式请求被限流轮询太频繁列表接口用limit控制单批大小靠 cursor 翻页而不是高频重发另外两个容易踩的坑一是 token 里可能含%等字符复制时要保证完整CLI 内部专门有normalizeToken做 decode二是生产、dev、local 三套环境的 API 地址和 Web 域名是配对映射的自部署时别把地址混着配。 文档、社区与贡献入口想继续深挖三个入口都放在仓库里命令全集和输出约定看 apps/cli/skill.md各条命令的参数实现看 apps/cli/src/commands/参与开发则按 CONTRIBUTING.md 的指南提 issue 或 PR。跑通第一个请求之后剩下的就是把 Folo 的数据流接进你自己的自动化里——这件事不难值得动手试一次。【免费下载链接】follow Folo is the AI RSS Reader项目地址: https://gitcode.com/GitHub_Trending/fol/follow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Folo 开放API第三方集成实战：3步拿到密钥、发出第一个请求并看懂返回结果
Folo 开放API第三方集成实战3步拿到密钥、发出第一个请求并看懂返回结果【免费下载链接】follow Folo is the AI RSS Reader项目地址: https://gitcode.com/GitHub_Trending/fol/followFolo 是一个 AI RSS 阅读器它把订阅源、精选列表和内容时间线都放在服务端统一管理而它的开放 API默认入口在 apps/cli/src/client.ts 里写明的api.folo.is就是把这些能力开放出来任何脚本、机器人或你自己的小应用都能通过一组 REST 接口读写订阅、拉取时间线、批量标记已读。简单说你不用再对着 App 点点点一条命令或一个 fetch 就能把 Folo 变成你工作流里的数据源。 先说清楚什么情况下你会用到 Folo API想象两个场景。一个是运营同学老周她每天要盯十几个技术订阅源希望每天早上 8 点自动把昨日未读文章喂给 AI 总结推到工作群。手动点根本做不到定时但如果未读数、文章列表都能用接口拿这事就是一个定时脚本的事。另一个是做 AI Agent 的人想让 Agent 能替用户查我订阅了什么有哪些没读的甚至帮用户增删订阅。Folo 官方 CLI 本身就是一份现成的 API 调用范例连 Agent 用的说明书都写好了可以直接对照着接。所以 Folo 开放 API 解决的核心问题是把人肉在 App 里操作变成程序按接口协议自动操作。 三步上手从拿到密钥到看懂第一个返回第一步拿到你的 API 密钥session tokenFolo API 用的是 Bearer Token 认证也就是你的 session token。最省事的方式是用官方 CLI 走一遍浏览器登录npx --yes foloclilatest login这条命令会拉起浏览器完成 Folo 账号登录通过本地一次性回调把 token 换回来并写进本地配置整个过程约 3 分钟超时保护实现细节可以看 apps/cli/src/browser-login.ts。如果是在服务器上跑没有浏览器就手动指定 token或者用环境变量npx --yes foloclilatest login --token 你的token export FOLO_TOKEN你的token第二步发出第一个真实请求登录成功后发个请求验证一下。直接调 session 检查接口就能看懂整个认证模式——Authorization头里放 Bearer token再带上对应的 cookieconst res await fetch(https://api.folo.is/better-auth/get-session, { headers: { Authorization: Bearer ${token}, Cookie: __Secure-better-auth.session_token${token}, }, }); const session await res.json();返回里能看到你的用户信息、角色、订阅配额feedSubscriptionLimit 这些字段这等于顺手完成了权限自检。第三步看懂返回结果学会翻页Folo 的接口返回是统一的 JSON 信封结构成功是{ ok: true, data: {...} }失败是{ ok: false, error: { code, message } }这个约定在 apps/cli/skill.md 里写得很清楚写自动化时照着解析就行。时间线这类列表接口额外返回entries、nextCursor、hasNext三个字段拿到nextCursor再传回--cursor就能翻下一页循环到hasNext为false就到底了。 进阶玩法三个最值钱的集成场景场景一定时机器人每天自动消化未读组合unread counttimeline --unread-onlyentry mark-read三条命令就是一个完整的拉未读→处理→标记闭环npx --yes foloclilatest timeline --unread-only --limit 20 npx --yes foloclilatest entry mark-all-read --view articles老周那个喂给 AI 总结的机器人骨架就是这两条命令加一层定时触发。场景二订阅迁移与备份opml export --output backup.opml一条命令导出全部订阅opml import导回来。换平台、备份、给新设备播种订阅源都不用手点。场景三自己部署时如何接收外部回调如果你要把 Folo 的自部署版接进自己的发布流程可以研究一下 api/vercel_webhook.ts它展示了 Folo 团队自己是怎么处理外部 webhook 的——HMAC-SHA1 校验请求体签名x-vercel-signature头、密钥缺失时返回 400、签名不匹配返回 403。自己写集成回调时照抄这套校验姿势安全性就有了基本盘。 避坑清单高频报错对照排查报错 / 现象大概率原因怎么修UNAUTHORIZED/ 401token 过期、复制不完整或漏了 cookie 头重新login服务端场景检查FOLO_TOKEN是否完整INVALID_ARGUMENT参数不合法比如--feed、--list、--category同时传了跑一下命令 --help看接受哪些参数4xx / 5xx自部署时--api-url指向错环境加--verbose看完整请求和状态码再定位JSON 解析失败请求体不是合法 JSON或缺Content-Type: application/json打印原始响应体先JSON.parse确认格式请求被限流轮询太频繁列表接口用limit控制单批大小靠 cursor 翻页而不是高频重发另外两个容易踩的坑一是 token 里可能含%等字符复制时要保证完整CLI 内部专门有normalizeToken做 decode二是生产、dev、local 三套环境的 API 地址和 Web 域名是配对映射的自部署时别把地址混着配。 文档、社区与贡献入口想继续深挖三个入口都放在仓库里命令全集和输出约定看 apps/cli/skill.md各条命令的参数实现看 apps/cli/src/commands/参与开发则按 CONTRIBUTING.md 的指南提 issue 或 PR。跑通第一个请求之后剩下的就是把 Folo 的数据流接进你自己的自动化里——这件事不难值得动手试一次。【免费下载链接】follow Folo is the AI RSS Reader项目地址: https://gitcode.com/GitHub_Trending/fol/follow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考