确认邮箱变更

POST

/api/v1/auth/email-change/confirm

验证码正确后更新邮箱、撤销全部登录会话，并在同一事务中排队向旧邮箱发送安全告警。
安全告警与验证码邮件均采用 at-least-once（至少一次）投递；数据库终结写入结果不
确定时，后续重试可能造成重复邮件，目的是避免关键安全通知永久漏发。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "challenge_id": "331c5928-fdd1-4016-9993-1395c38cce7b",
    "code": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/auth/email-change/confirm' \
--header 'X-CSRF-Token;' \
--header 'Content-Type: application/json' \
--data '{
    "challenge_id": "331c5928-fdd1-4016-9993-1395c38cce7b",
    "code": "string"
}'

返回响应

🟢204删除成功

邮箱已变更并撤销全部会话

该响应没有 Body

🟠400请求有误

🟠401没有权限

🟠409

🟠429

🔴500服务器错误

修改于 2026-09-03 11:57:51

发起邮箱变更

获取本人头像字节