跳到主要内容

删除当前用户信息

DELETE 
/auth/v1/user/me

接口说明​

删除当前用户信息，需要先通过重新认证接口发送验证码进行二次验证才能执行。该操作会永久删除用户账号及相关数据，请谨慎使用。

功能特性​

  • 永久删除当前用户账号
  • 需要通过重新认证接口发送验证码进行二次验证确保安全
  • 删除后无法恢复，需谨慎操作
  • 支持软删除和硬删除两种模式

入参要求​

必需参数​

  • Authorization: 当前登录用户的access_token（必填，Bearer格式）
  • verify_code: 验证码（必填，通过重新认证接口发送到用户手机或邮箱的验证码）
  • client_id: 应用对应的客户端id（可选，默认为环境id）
  • x-device-id: 设备id（可选，当前登录设备的id）

请求体参数​

  • 无请求体参数

前置条件​

  • 用户必须已登录并持有有效的access_token
  • 必须通过重新认证接口发送验证码
  • 验证码有效期为300秒（5分钟）
  • 用户确认要删除自己的账号

出参说明​

成功响应​

  • 返回空对象，表示删除成功

请求示例​

删除用户请求示例​

DELETE /auth/v1/user/me?verify_code=121688
Authorization: Bearer your_access_token
Content-Type: application/json

响应示例​

删除成功响应​

{}

验证码无效响应​

{
  "error": "permission_denied",
  "error_code": 7,
  "error_description": "bad verify code"
}

用户不存在响应​

{
  "error": "user_not_found",
  "error_code": 4004,
  "error_description": "用户不存在或已被删除"
}

使用流程​

1. 发起重新认证​

2. 用户收到验证码​

  • 用户在手机或邮箱中查看验证码
  • 验证码有效期为300秒（5分钟）

3. 确认删除​

  • 前端应显示确认对话框
  • 用户确认删除操作

4. 执行删除​

  • 调用此接口删除用户
  • 传入verify_code（用户收到的验证码）进行二次验证

5. 清理客户端数据​

  • 删除成功后清理本地存储
  • 跳转到登录页面

相关接口​

错误处理​

常见错误场景​

  • 验证码过期：提示用户重新发送验证码
  • 验证码错误：检查验证码是否正确
  • 网络异常：重试机制
  • 服务器错误：显示友好错误信息

Request​

Responses​

A successful response.

Response Headers