发送邮箱验证码#

验证状态：已源码核验、未联调；适用基线：冻结 inventory（2026-09-11）；核验日期：2026-09-11

用途与场景#

发送注册、改密、找回或停用所需的邮箱验证码，并轮换下一次签名随机数。

使用位置#

注册、找回与停用页经 userCenterUserEmailSendVerificationCodeApi 调用。

端点#

POST /main-service/system-api/user-center/user-email/sendVerificationCode — 发送邮箱验证码并轮换签名随机数。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 user-center · user-email 用户邮箱；emailCrypto wire 惯例、频控（24 小时 10 条、60 秒内 1 条）与异步送达语义见用户中心业务 · user-email 用户邮箱。

动线与完成判据#

先经获取验证码随机数取随机数，再按平台约定由随机数与邮箱计算 emailCrypto 一并提交（该值的生成算法属于内部实现，不在文档披露范围，具体生成方式请与开发人员沟通确认）。完成判据是异步语义：业务成功只表示已发布邮件发送消息并写入验证码缓存，不等于收件箱已送达；响应 data 是轮换后的下一次签名随机数，不是验证码本身。

错误与边界#

随机数缺失或签名不符、类型非法、邮箱已存在/不存在、频控超限均失败；dev profile 跳过频率限制。错误出口见错误响应差异。

已知缺口#

邮件消费者、第三方投递回执和实际模板配置未核验。