API 实验室 · 18 个接口在线调试

左边选接口，右边看文档、填参数、点发送——请求打的是线上真后端（本站服务器上的 hiwen-api 服务），响应原文、耗时、状态码一览无余。要调 ★ 需登录的接口，先用上方登录条拿 token。

还有一份标准 Swagger 文档：/apidocs ——点开任意接口 → Try it out → Execute，直接看到服务器返回的真实 JSON（右上角 Authorize 可填 token）。本页偏「中文讲解 + 为什么这么设计」，Swagger 偏「标准契约 + 快速调试」，搭配着用。

统一响应：HTTP 恒 200，业务成败看 code（200 成 / 400 参数 / 401 未登录 / 403 禁用 / 404 不存在）。 data 结构：列表类返回 {list,total,page,page_size}。完整约定见项目文档。

🔑 登录获取 token

未登录 —— 公开接口随便调；★ 接口需要 token，会自动附在请求头。