认证状态

GET /v1/auth/status

读取已脱敏的认证档案，以及 Minara 会话与连接状态。

响应正文

{
  "minara_connected": true,
  "minara_oauth_connected": true,
  "minara_source": "oauth-profile",
  "minara_session": {
    "state": "present",
    "connection": "ready"
  },
  "minara_account_scope": "opaque-account-scope",
  "minara_credential_revision": "opaque-credential-revision"
}

说明

示例仅展示 Minara 字段；响应还包含提供商配置和已脱敏的档案。minara_session.state 为 absent、present、reauth_required 或 unknown；独立的 connection 为 ready、refreshing 或 unavailable。present 表示保留本地授权上下文，服务器此时可能无法访问。unknown 表示凭据暂时无法读取。可选的 reason 说明明确的拒绝或密钥存储问题。连接不可用本身不应触发登录。

将 minara_account_scope 作为不透明的缓存分区标识；它变化时清除与账户绑定的缓存。凭据无法读取期间可能不返回该字段，单凭缺失不能判断用户已退出。不要解析它或将它用于认证。旧版连接布尔值仍然可用；minara_oauth_connected 明确要求 OAuth 身份，因此 API key 无法解锁 Web 应用。

minara_credential_revision 是当前已应用凭据的不透明版本标识，token 轮换、凭据或后端变更、进程重启时会变化；没有可读取的凭据时省略。客户端观察到已知版本变化后，可让暂停的读请求重新访问服务端；账号分区未变时保留缓存。版本不变或缺失时，不解除读请求暂停。新版本不代表权限提升，服务端仍可再次要求验证。不要自动重放失败的写操作，也不要将该标识用于认证。