{
  "version": 1,
  "name": "jinrikan-api-catalog",
  "title": "今日看 API 目录",
  "updated": "2026-08-27",
  "apis": [
    {
      "id": "openapi",
      "name": "开放平台 REST API",
      "description": "平台清单 / 单平台热榜 / 跨平台话题聚类，jrk_* Key 鉴权，免费档 200 次/天",
      "baseUrl": "https://www.jinrikan.com/api/openapi/v1",
      "spec": "https://www.jinrikan.com/openapi.yaml",
      "docs": "https://www.jinrikan.com/open",
      "auth": { "type": "apiKey", "in": "header", "name": "Authorization", "scheme": "Bearer jrk_*" },
      "keyManagement": "https://www.jinrikan.com/open"
    },
    {
      "id": "mcp",
      "name": "MCP Server",
      "description": "Model Context Protocol（Streamable HTTP，纯 POST 模式）：get_top_topics / get_platform_hot / list_platforms",
      "endpoint": "https://www.jinrikan.com/api/mcp",
      "protocol": "mcp-streamable-http",
      "auth": { "type": "none" },
      "rateLimit": "30 次/分钟/IP"
    },
    {
      "id": "public-feeds",
      "name": "公开只读端点",
      "description": "无需鉴权的热榜与订阅端点",
      "endpoints": [
        { "method": "GET", "path": "/api/top.json", "description": "全网总榜话题 TOP30（JSON）" },
        { "method": "GET", "path": "/api/{platform}", "description": "单平台热榜（platform 见 /api/health 的 platforms 清单）" },
        { "method": "GET", "path": "/api/{platform}?rss=true", "description": "单平台 RSS 订阅" },
        { "method": "GET", "path": "/api/feed/keyword.xml?kw={关键词}", "description": "关键词订阅 RSS（近 24h 新上榜命中）" },
        { "method": "GET", "path": "/rss.opml", "description": "全平台 OPML 订阅清单" }
      ],
      "auth": { "type": "none" }
    }
  ]
}