公开 API

约定

• 基础地址：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 的博客。

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 小时才会变化，请在您这边做缓存，别按秒轮询；
• 展示文章时请保留指向原文的链接，版权属于各博客作者；
• 需要别的字段或接口，联系我们聊聊。