文档
公共数据、验证码与运行信息
公共数据、验证码与运行信息
公共数据、验证码与运行信息
依据当前 Rust 工程 655097d2a5 的 PoolNode 路由、控制器、DTO 和鉴权中间件核对(2026-11-02)。上游返回字段不在本地 Rust 中定义的,以下仅列已确认的请求契约,不把历史示例作为固定响应结构。
| API | 鉴权和返回 |
|---|---|
GET /api/network/mergemining |
公开,无参数;合并挖矿数据,统一响应外层,上游决定 data |
GET /api/quotes |
无需用户 JWT,无参数;需要节点 CODE 可用,统一响应外层,上游决定 data |
GET /api/project/info |
用户 JWT,无参数;统一外层,在上游配置上补充 node、version、start_time |
GET /api/version |
公开,无参数;原样返回发布仓库 origin.json,不是本机运行版本,不加统一外层 |
GET /api/runtime/debug |
公开,无参数;直接返回 debug、shadow 两个布尔字段,响应头 Cache-Control 为 no-store |
POST /api/captcha/image |
公开,无请求参数;验证码服务原始 JSON |
POST /api/captcha/check |
公开;JSON 为验证码组件生成的校验载荷,原样转发并返回验证码服务 JSON |
project/info 中 version 是当前程序版本,start_time 来自本机启动时间;node 含随机前缀,不宜作稳定节点 ID。runtime/debug 是诊断查询,不提供设置开关。
验证码校验字段由验证码组件协议决定,本地只接收 JSON,不定义固定 DTO。优先使用文档中的验证码组件获取成功 Token,再传给邮件接口;不要把验证码服务原始响应当成统一 status/data 外层。
