错误码

所有错误响应统一格式：

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "未认证或令牌无效",
    "details": null
  }
}

标准错误码

HTTP 状态	code	含义
400	BAD_REQUEST	请求参数错误（缺字段、格式错误等）
401	UNAUTHORIZED	未提供令牌，或令牌无效 / 已过期
403	FORBIDDEN	无权访问该资源
404	NOT_FOUND	资源不存在
409	CONFLICT	资源冲突（如邮箱已注册）
410	GONE	资源已失效（如分享已过期）
413	PAYLOAD_TOO_LARGE	上传内容超出大小限制（100MB）
422	UNPROCESSABLE_ENTITY	请求格式正确但语义错误
429	TOO_MANY_REQUESTS	触发限流，请稍后重试
500	INTERNAL_ERROR	服务器内部错误

语义化错误码（特殊场景）

code	HTTP	触发场景
device_revoked	401	设备已被吊销（含重用检测触发）
dev_disabled	403	账号已被停用（dev_enabled=false）
invalid_grant	401	OAuth 授权码无效或已过期

说明

• details 字段仅部分错误携带，提供额外上下文（如字段校验失败的具体信息）。
• 限流错误（429）触发后，请按 Retry-After 头（若有）或指数退避重试。
• 设备相关错误（device_revoked / dev_disabled）发生时，需重新打开桌面工作台登录。