{"openapi":"3.0.3","info":{"title":"小喵热点 API","version":"1.0.0","description":"DailyHotApi 数据源。按需缓存 30 分钟；上游故障最多回退 24 小时并标记 stale。无每日配额。GET 接口。"},"servers":[{"url":"https://hot.xiaomiao.store"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"paths":{"/health":{"get":{"security":[],"summary":"服务存活检查，不代表各上游可用","responses":{"200":{"description":"服务运行中"}}}},"/api/v1/sources":{"get":{"summary":"平台清单与最近调用状态；unknown 表示尚未验证","responses":{"200":{"description":"数据源列表"},"401":{"description":"缺少或错误的 API Key"}}}},"/api/v1/hot/{source}":{"get":{"summary":"读取一个平台的默认热榜","parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string","enum":["36kr","51cto","52pojie","acfun","baidu","bilibili","coolapk","csdn","dgtle","douban-group","douban-movie","douyin","earthquake","gameres","geekpark","genshin","github","guokr","hackernews","hellogithub","history","honkai","hostloc","hupu","huxiu","ifanr","ithome","ithome-xijiayi","jianshu","juejin","kuaishou","linuxdo","lol","miyoushe","netease-news","newsmth","ngabbs","nodeseek","nytimes","producthunt","qq-news","sina","sina-news","smzdm","sspai","starrail","thepaper","tieba","toutiao","v2ex","weatheralarm","weibo","weread","yystv","zhihu","zhihu-daily"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"keyword","in":"query","description":"按标题和描述筛选，不是站内搜索","schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"热榜数据，热度值由平台提供，不宜跨平台直接比较","content":{"application/json":{"example":{"code":200,"source":"weibo","title":"微博","type":"热搜榜","total":1,"updatedAt":"2026-09-08T00:00:00.000Z","fetchedAt":"2026-09-08T00:00:00.000Z","cached":true,"stale":false,"data":[{"rank":1,"id":"example","title":"示例标题（非实时数据）","url":"https://example.com","hot":12345,"desc":""}]}}}},"400":{"description":"无效参数"},"401":{"description":"缺少或错误的 API Key"},"404":{"description":"未知平台"},"429":{"description":"请求过快"},"502":{"description":"上游不可用或无有效数据"},"503":{"description":"上游请求并发已满"}}}}}}