POST /auth/register/check-email

在用户注册前校验邮箱是否已被注册,防止重复注册与临时邮箱滥用。支持GET和POST两种请求方式。参考:OWASP ASVS V2.2。

身份认证 None application/json

请求参数

名称位置类型必填默认值示例约束描述
email query string 否 邮箱地址(GET方式)

请求体

Schema: service-identity/internal/handler/dto.CheckEmailRequest

字段类型必填示例约束描述
email string 是 user@example.com Email
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 Email