约定
- 基础地址:
https://bo.ke,全部为 GET 请求,返回 application/json; charset=utf-8; - 只包含公开数据:已收录且正常状态的博客,被封禁用户的条目不会出现;
- 文章来自各博客的 RSS,系统每 6 小时抓取一次,每个博客保留最近 20 篇;
- 出错时返回
{"error": "说明"} 和对应的 HTTP 状态码。
GET /api/blogs
全部收录博客,含每个博客的最新一篇文章。无参数。
curl https://bo.ke/api/blogs
返回数组,每项:
{
"slug": "u.sb", // 域名,也是博客页地址 https://bo.ke/u.sb/
"name": "烧饼博客",
"link": "https://u.sb/",
"rss": "https://u.sb/feed.xml",
"avatar": "https://…", // 已处理的头像地址(160px)
"description": "…",
"author": "Showfom",
"tags": [{"slug": "tech", "name": "技术"}],
"weight": 120, // 展示权重:120 / 100 / 50
"backlink_status": "ok", // 互链状态:ok / missing / unknown
"verified": true, // 域名所有权已验证
"latest_post": { // 可能为 null
"title": "…",
"url": "https://…",
"published_at": "2026-07-09T08:00:00Z"
}
}
GET /api/posts
全站最新文章,按发布时间倒序,只包含权重 ≥ 50 的博客。
| 参数 | 说明 |
|---|
limit | 返回条数,正整数。默认 100,上限 200。 |
curl "https://bo.ke/api/posts?limit=20"
返回数组,每项:
{
"blog_slug": "u.sb",
"blog_name": "烧饼博客",
"blog_author": "Showfom",
"blog_avatar": "https://…", // 已处理的头像地址(96px)
"title": "…",
"url": "https://…", // 指向博客原文
"summary": "…", // 纯文本摘要
"published_at": "2026-07-09T08:00:00Z"
}
GET /api/blogs/{slug}/posts
单个博客的最近文章(最多 20 篇),按发布时间倒序。slug 就是博客域名。
curl https://bo.ke/api/blogs/u.sb/posts
返回结构与 /api/posts 相同;博客不存在或已下线时返回 404 与错误说明。
使用须知
- 数据每 6 小时才会变化,请在你这边做缓存,别按秒轮询;
- 展示文章时请保留指向原文的链接,版权属于各博客作者;
- 需要别的字段或接口,联系我们聊聊。