认证与健康探针
3.1 POST /v1/api/auth/verify
校验已有静态令牌;不是登录换取新 token,不建立 Cookie 会话。
| 请求字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | authRequired=true 时是 | 待验证的 API 令牌 |
{"token":"replace-with-your-device-token"}
完整成功响应:
{"code":0,"msg":"success","data":{"username":"operator"}}
启用 Bearer 校验时,缺失 token 或 JSON 非法为 400/1001,无效 token 为 401/1006;关闭校验时直接返回 developer,不校验请求体。
3.2 GET /v1/api/auth/me
无请求体。启用 Bearer 时响应为 token 对应身份,如 data={"username":"operator"};dev 和兼容接管模式为 developer,制造检测路由身份为 factory_local。可用此接口观察认证行为,但返回 developer 不足以判定 run_mode=dev。
3.3 GET /healthz
无需认证,无请求体。完整响应:
{"code":0,"msg":"success","data":{"status":"ok"}}
只用于 HTTP 进程存活探测,不保证导航、Docker、运动控制、RTK 或云链路健康。