{"components":{"schemas":{"Article":{"description":"文章。列表默认不含 contentMd；includeContent=1 或详情接口才返回正文。","properties":{"author":{"properties":{"handle":{"type":"string"},"nickname":{"type":"string"},"url":{"type":"string"}},"type":"object"},"category":{"properties":{"name":{"type":"string"},"slug":{"type":"string"}},"type":["object","null"]},"commentCount":{"type":"integer"},"contentMd":{"description":"Markdown 正文","type":"string"},"coverUrl":{"type":["string","null"]},"excerpt":{"type":"string"},"id":{"type":"string"},"likeCount":{"type":"integer"},"publishedAt":{"type":["string","null"]},"slug":{"description":"稳定的文章标识，详情接口用它","type":"string"},"tags":{"items":{"$ref":"#/components/schemas/Tag"},"type":"array"},"title":{"type":"string"},"updatedAt":{"type":"string"},"url":{"description":"站内阅读地址","type":"string"},"viewCount":{"type":"integer"}},"type":"object"},"Envelope":{"properties":{"code":{"description":"0 成功；401 未认证；404 不存在；429 超限","type":"integer"},"data":{"description":"成功时的数据；失败为 null"},"msg":{"type":"string"}},"required":["code","data","msg"],"type":"object"},"Tag":{"properties":{"name":{"description":"展示名，可能是中文","type":"string"},"slug":{"description":"URL 用标识，可直接作为 tag 参数","type":"string"}},"type":"object"}},"securitySchemes":{"bearerAuth":{"description":"在开放平台创建的 API Key（形如 dhk_…）。也接受 X-API-Key 头。","scheme":"bearer","type":"http"}}},"info":{"description":"查询 DecryptHub 已发布的安全研究文章。所有接口使用 Authorization: Bearer \u003cAPI Key\u003e；Key 在站点「设置 · 开放平台」创建。响应统一为 {code,data,msg}，code=0 表示成功。","license":{"name":"Site terms","url":"https://decrypthub.cn/terms"},"title":"DecryptHub Open API","version":"v1"},"openapi":"3.1.0","paths":{"/articles":{"get":{"description":"按发布时间倒序（sort=hot 时按热度）。支持游标（cursor）或页码（page）分页。","parameters":[{"description":"全文关键词，匹配标题、摘要与正文","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"标签 slug","in":"query","name":"tag","required":false,"schema":{"type":"string"}},{"description":"分区 slug","in":"query","name":"category","required":false,"schema":{"type":"string"}},{"description":"作者 handle（可带 @）","in":"query","name":"author","required":false,"schema":{"type":"string"}},{"description":"latest（默认）或 hot","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"起始日期 YYYY-MM-DD（含）","in":"query","name":"since","required":false,"schema":{"type":"string"}},{"description":"结束日期 YYYY-MM-DD（含）","in":"query","name":"until","required":false,"schema":{"type":"string"}},{"description":"每页条数，1–50，默认 10","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"上一页返回的 nextCursor","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"页码，从 1 开始；与 cursor 二选一","in":"query","name":"page","required":false,"schema":{"type":"string"}},{"description":"1 时返回 Markdown 正文","in":"query","name":"includeContent","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"文章分页结果"}},"summary":"列出已发布文章"}},"/articles/{slug}":{"get":{"parameters":[{"description":"文章 slug","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"文章详情"},"404":{"description":"文章不存在或未发布"}},"summary":"按 slug 读取一篇已发布文章（含 Markdown 正文）"}},"/categories":{"get":{"responses":{"200":{"description":"分区数组"}},"summary":"分区列表（含文章数）"}},"/me":{"get":{"responses":{"200":{"description":"Key 信息、用户、限流与可用端点"}},"summary":"当前 Key 与账号信息"}},"/search":{"get":{"description":"与 /articles?q= 相同，但要求提供查询词；建议 AI 先搜索再按 slug 取详情。","parameters":[{"description":"查询词（必填）","in":"query","name":"q","required":true,"schema":{"type":"string"}},{"description":"1–50，默认 10","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"1 时返回 Markdown 正文","in":"query","name":"includeContent","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"文章列表"}},"summary":"全文搜索（q 必填）"}},"/tags":{"get":{"parameters":[{"description":"1–200，默认 50","in":"query","name":"limit","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"标签数组"}},"summary":"热门标签列表"}}},"security":[{"bearerAuth":[]}],"servers":[{"description":"DecryptHub","url":"https://decrypthub.cn/open/v1"}]}