知乎热榜速读

先解决什么麻烦

热榜数据常散落在页面或第三方接口里，手动抓取不仅慢，返回的字段也常有缺失：标题不全、缺缩略图、摘要截断，想做后续分析还得花时间清洗格式。这个技能直接对接知乎开放平台的 hot_list API，省去自己写爬虫或对接非官方接口的麻烦，一次调用就能拿到规范的热榜数据。

怎么拿到可用数据

1. 认证：通过环境变量 ZHIHU_ACCESS_SECRET 完成接口鉴权，密钥需从知乎开放平台控制台获取。
2. 参数适配：支持可选参数 limit（默认30，自动规范到1-30范围）；可通过 ZHIHU_OPENAPI_BASE_URL 或 ZHIHU_HOT_LIST_URL 自定义API地址。
3. 结果整理：自动过滤非对象的无效条目，将有效数据整理为包含 title、url、thumbnail_url、summary 的列表；返回统一的JSON格式，包含 code、message、total、item_count 和 items 数组，无数据时字段返回空字符串而非缺失。

需要注意的边界

• 需先在知乎开放平台申请权限并配置 ZHIHU_ACCESS_SECRET，否则接口会返回认证错误
• limit 超过30时会被自动规范，不会触发接口异常
• 接口返回非2xx状态码时，会额外携带响应 body 方便排查问题
• 缩略图和摘要依赖服务端返回，无数据时为空字符串，无需额外处理缺失逻辑