/auth/register/check-email
在用户注册前校验邮箱是否已被注册,防止重复注册与临时邮箱滥用。支持GET和POST两种请求方式。参考:OWASP ASVS V2.2。
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
email |
query |
string |
否 | 邮箱地址(GET方式) |
请求体
Schema: service-identity/internal/handler/dto.CheckEmailRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
email |
string |
是 | user@example.com |
||
tenant_id |
string |
否 | TenantID 显式租户(地址栏):body > query > X-Tenant-ID;空即 400(AUTH-09)。 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 邮箱可用性检查结果 | service-identity/internal/handler/dto.CheckEmailResponse |
| 400 | 请求参数无效 | service-core/base/dto.SimpleResponse |
| 500 | 服务器内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-identity/internal/handler/dto.CheckEmailResponse
检查邮箱可用性结果
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
available |
boolean |
否 | True |
Is available | |
email |
string |
否 | user@example.com |