跳到主要内容

认证与健康探针

3.1 POST /v1/api/auth/verify​

校验已有静态令牌;不是登录换取新 token,不建立 Cookie 会话。

请求字段类型必填说明
tokenstringauthRequired=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 或云链路健康。