{"openapi":"3.1.0","info":{"title":"HN Qiaomu API","version":"0.1.0","description":"面向中文 Hacker News 阅读器和未来 iOS App 的公共 API。"},"servers":[{"url":"https://hn.qiaomu.ai"}],"paths":{"/api/health":{"get":{"summary":"服务健康检查","responses":{"200":{"description":"OK"}}}},"/api/topics":{"get":{"summary":"获取内置主题","responses":{"200":{"description":"Topic list"}}}},"/api/stories":{"get":{"summary":"读取单个主题或自定义搜索的 HN 条目","parameters":[{"name":"topic","in":"query","schema":{"type":"string"}},{"name":"feed","in":"query","schema":{"type":"string"}},{"name":"query","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"minPoints","in":"query","schema":{"type":"integer"}},{"name":"minComments","in":"query","schema":{"type":"integer"}},{"name":"translate","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Story list"}}}},"/api/stories/merge":{"post":{"summary":"合并多个订阅主题","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"topics":{"type":"array","items":{"type":"string"}},"limitPerTopic":{"type":"integer","minimum":1,"maximum":50},"translate":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Merged story list"}}}},"/api/translate":{"post":{"summary":"翻译传入 story 列表","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"force":{"type":"boolean"},"stories":{"type":"array","items":{"type":"object"}}}}}}},"responses":{"200":{"description":"Translation map"}}}}}}