获取验证码随机数#

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

用途与场景#

为手机或邮箱验证码签名取得一次六位随机数；它不是验证码，不能直接用于注册或找回密码。

使用位置#

认证页的注册、找回密码和停用流程调用 userCenterUserGetRandomNumericByKeyApi。

端点#

GET /main-service/system-api/user-center/user/getRandomNumericByKey — 取一次六位验证码签名随机数（query 参数 key）。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 user-center · user 用户；随机数的轮换供给侧（混淆码定时任务与缓存）见用户中心业务 · user 用户。

动线与完成判据#

HTTP 成功且业务信封成功只表示随机数已生成并缓存；下一步必须用它计算对应联系方式的签名——邮箱族的 emailCrypto 与手机号族的 phoneNumberCrypto wire 惯例见用户中心业务 · user-email 用户邮箱与用户中心业务 · user-phone-number 用户手机号。

错误与边界#

空 key 触发校验失败；错误信封的适用最终出口待逐请求安全链复核，见错误响应差异。不可重试语义未核验。

已知缺口#

无已知关键缺口；未执行真实联调。