Java SDKgRPC 服务
Public 服务
公共服务:验证码发送
Public 服务
Public 服务提供无需认证的公共功能,主要用于发送验证码。
接口概览
| 方法 | 说明 | 认证 |
|---|---|---|
SendRegisterEmailCode | 发送注册邮箱验证码 | 无 |
SendRegisterEmailCode
发送注册邮箱验证码。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
email | string | Yes | 目标邮箱地址 |
purpose | string | No | 用途(默认为注册) |
响应
基础响应信息,无额外数据字段。
使用示例
// 发送验证码
ssoApi.pub().sendRegisterEmailCode(
SendRegisterEmailCodeRequest.newBuilder()
.setEmail("user@example.com")
.build()
);
System.out.println("验证码已发送");限制说明
| 限制 | 说明 |
|---|---|
| 有效期 | 15 分钟(可通过 EMAIL_VERIFY_CODE_EXPIRE 环境变量配置) |
| 频率限制 | 同一邮箱 1 分钟内只能发送一次 |
错误码
| 错误 | 说明 |
|---|---|
INVALID_ARGUMENT | 邮箱格式无效 |
RESOURCE_EXHAUSTED | 发送频率超限 |
UNAVAILABLE | 邮件服务不可用 |
HTTP 路由
SDK 同时提供 HTTP 路由封装:
POST /public/register/email/code
Content-Type: application/json
{
"email": "user@example.com"
}