开放平台 API
简介
开放平台提供与站内同源的标准化数据接口：49 个平台热榜（每 15 分钟更新）与全网话题跨平台聚类结果，适合开发者构建自己的热榜应用、数据分析、机器人推送等场景。
快速开始
1. 注册并登录 今日看（首页右上角）；2. 头像菜单「开放平台」创建 API Key；3. 按下方示例携带 Key 调用。
# 全部平台清单 curl -H "Authorization: Bearer jrk_xxx" https://www.jinrikan.com/api/openapi/v1/nodes # 单平台热榜（如微博） curl -H "Authorization: Bearer jrk_xxx" https://www.jinrikan.com/api/openapi/v1/node/weibo # 全网话题聚类 top30 curl -H "Authorization: Bearer jrk_xxx" https://www.jinrikan.com/api/openapi/v1/topics
接口列表
| 端点 | 方法 | 说明 |
|---|---|---|
| /api/openapi/v1/nodes | GET | 全部可用平台清单（id/名称/分类） |
| /api/openapi/v1/node/:platform | GET | 单平台热榜 top10，参数 limit 可至 30 |
| /api/openapi/v1/topics | GET | 跨平台话题聚类 top30（关键词/平台/热度） |
OpenAPI 规范与 Agent 发现
机器可读的 OpenAPI 3.0 规范：/openapi.yaml（可直接导入 Postman / Apifox / Swagger Editor）。AI Agent 自动发现入口：/.well-known/api-catalog与 /.well-known/agent-skills； MCP Server 端点 /api/mcp（Streamable HTTP，免鉴权）。
错误码
| HTTP | code | 含义 |
|---|---|---|
| 400 | BAD_REQUEST | 参数错误（如 limit 越界） |
| 401 | UNAUTHORIZED | 缺少或无效 API Key |
| 403 | FORBIDDEN | Key 已禁用 |
| 404 | NOT_FOUND | 平台不存在 |
| 429 | RATE_LIMITED | 超出当日配额（次日 0 点重置） |
| 500 | INTERNAL | 服务器内部错误 |
配额与重置
每个 Key 每日免费 200 次，东八区 0 点重置。响应头 x-ratelimit-limit / x-ratelimit-remaining / x-ratelimit-reset 实时返回配额信息。更大额度需求请通过仓库 Issue 联系。