很多产品里「邮箱登录」是用户进来的第一步,但您可能也观察到:用户输入邮箱后,要等几秒收到邮件、打开邮件、复制 6 位数字、切回页面、粘贴、提交——一连串步骤里任何一步 出问题都可能让人放弃。
CloudBase 邮箱登录现在新增 Magic Link 模式:用户输入邮箱后,邮件里收到一条登录链接,点一下就完成登录,不需要再敲 6 位验证码。
这个改动给您带来什么
- 用户登录路径少 3 步:少了「看验证码 → 复制 → 切回 → 粘贴」四个动作
- 托管登录页直接生效:开启后,邮箱登录区域自动显示「发送登录链接」按钮
- 跳转地址可配:用户点击链接验证通过后,自动跳转到您指定的页面(订单页、Dashboard 等)
- 两种模式按需切:保留邮箱验证码的产品也不受影响,按业务调即可
怎么开始
- 进云开发控制台 → 身份认证 → 登录方式选择 → 邮箱登录
- 选择 Magic Link 模式(或保留验证码模式)
- 如需自定义跳转地址,在发送验证请求时传入
email_redirect_to
实际怎么调用
Magic Link 模式下,发送邮箱验证请求时传入 email_redirect_to 参数即生效:
{
"email": "user@example.com",
"target": "ANY",
"email_redirect_to": "https://your-domain.com/dashboard"
}
不传 email_redirect_to 时,自动 fallback 到验证码模式:
{
"email": "user@example.com",
"target": "ANY"
}
跳转地址必须是完整 URL,且只能是 CloudBase 默认域名或已配置的自定义域名(避免用户点开链接后跳转失败)。
注意
- Magic Link 支持邮箱登录
- 默认有效期 600 秒,点击使用后即失效
- 托管登录页和自定义 SMTP 都已适配,两种模式都能用

