← 返回阅读器

乔木 HN 速读 API

给网页和未来 iOS 共用的接口。

所有响应都是 JSON；翻译只在服务端调用 DeepSeek，客户端不接触密钥。

Health

GET /api/health

服务、版本、时间、翻译模型和启用状态。

Status

GET /api/status

后台快照、刷新周期和评论预热的运行状态。

Topics

GET /api/topics

内置主题列表，含 feed、搜索 query 和 UI accent。

Insights

GET /api/insights

首页菜单使用的升温榜和产品雷达。

Stories

GET /api/stories?topic=frontpage&pointsSort=desc

从本地快照读取单主题条目，可加关键词、points 排序、评论数；默认带中文标题和看点。

Discussion

GET /api/stories/{id}/comments

返回已缓存评论、评论译文和中文讨论速读文章，适合点击展开时秒开。

Merged Feed

POST /api/stories/merge

请求体传 {"topics":["ai","show"],"translate":true}，返回去重后的订阅流。

Translate

POST /api/translate

传入 story 数组，返回以 story id 为 key 的中文标题、看点和标签。

OpenAPI

GET /api/openapi.json

机器可读契约，iOS 客户端可以按这个生成请求层。

iOS 请求示例

let url = URL(string: "https://hn.qiaomu.ai/api/stories?topic=frontpage")!
let (data, _) = try await URLSession.shared.data(from: url)
let feed = try JSONDecoder().decode(HNFeedResponse.self, from: data)