账户注销相关接口

注销账户

C2S POST /bp/user/me/deactivate

S2S POST /bp/server/user/{user_id}/deactivate

接口功能：注销账户

请求头部参数 (Headers)：

参考 接入 BytePower

X-BytePower-Sign：请求体签名 X-BytePower-Session-Token: 登录后获取用户的 session

请求体

无

响应

• HTTP 状态码：200

  描述：成功

  响应示例：

  无

• HTTP 状态码：4xx

  描述：错误

  响应示例：

{
  "error": {
    "error_type": "invalid_parameter",
    "message": "xxxxx"
  }
}

error_type：

• invalid_parameter（参数错误）
• operation_not_allowed（不允许的操作，比如有未处理的提现请求或其他安全限制）

账户立即注销

C2S POST /bp/user/me/deactivate/confirm

S2S POST /bp/server/user/{user_id}/deactivate/confirm

接口功能：对账户进行立即注销

请求头部参数 (Headers)：

参考 接入 BytePower

X-BytePower-Sign：请求体签名 X-BytePower-Session-Token：登录后获取用户的 session。

请求体

无

响应

• HTTP 状态码：200

  描述：成功，账户已彻底注销

  响应示例：

  无

• HTTP 状态码：4xx

  描述：错误

  响应示例：

{
  "error": {
    "error_type": "invalid_parameter",
    "message": "xxxxx"
  }
}

error_type：

• invalid_parameter（参数错误）

账户恢复

C2S POST /bp/user/me/deactivate/recover

S2S POST /bp/server/user/{user_id}/deactivate/recover

接口功能：对账户进行恢复

请求头部参数 (Headers)：

参考 接入 BytePower

X-BytePower-Sign：请求体签名 X-BytePower-Session-Token：登录后获取用户的 session。

请求体

无

响应

• HTTP 状态码：200

  描述：成功，账户已恢复

  响应示例：

  无

• HTTP 状态码：4xx

  描述：错误

  响应示例：

{
  "error": {
    "error_type": "invalid_parameter",
    "message": "xxxxx"
  }
}

error_type：

• invalid_parameter（参数错误）

注销账户后的影响

• 冻结期：账户进入冻结期，冻结期间支持用户“立即注销”和“恢复账号”。

• 登录限制：处于冻结期的账户无法登录，调用登录接口会返回冻结期剩余时间，如示例中所示：

{
  "error": {
    "error_type": "account.deactivate_pending_user",
    "extra": {
      "deactivate_left_sec": 604797,
      "deactivate_time_ms": 1715048615822,
      "pending_dur_sec": 604800
    },
    "message": "account.deactivate_pending_user"
  }
}

• 到期后自动注销：冻结期到期后，账户自动注销。

账户注销对各模块的影响

• Account：

  • 使用用户名（邮箱）、密码登录，返回提示信息：用户不存在。
  • 注销前绑定的手机号、微信等第三方账号可以再次绑定到新的匿名账号。
  • 使用注销前绑定的手机号、微信等第三方账号直接登录，则创建新账号。

• Asset：

  • 保留用户已经产生的购买历史记录。
  • 删除用户已经购买的资产。

• Pigat：

  • 删除与注销用户相关的 task/generator/automation。
  • Pigat 所有接口都不能调用。

• Storage：

  • 待排期实现：用户的私人存储（user storage）全部删除。

• Invitation：

  - 待排期实现：注销用户发出的邀请失效，被邀请用户注册后，也不会记录邀请关系。
  - 邀请码失效，填写失效的邀请码，返回提示信息：邀请码不存在。
  - 注销用户的邀请上下游用户，可以获取和注销用户的邀请关系。
  

  📢 注意：处于冻结期的账户无法登录，调用登录接口会失败并返回冻结期剩余时间，无法获得新的 Session-Token；因此用户注销账号之后，APP 端如果删除了本地的 Session-Token，则无法调用“立即注销”和“恢复账号”两个接口。