POST /auth/register/check-username

在用户注册前校验用户名是否已被占用,防止批量注册和冲突。支持GET和POST两种请求方式。参考:OWASP ASVS V2.2。

身份认证 None application/json

请求参数

名称位置类型必填默认值示例约束描述
username query string 否 用户名(GET方式)
tenant_id query string 否 目标租户(地址栏租户优先)

请求体

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

字段类型必填示例约束描述
username string 是 john_doe Username
tenant_id string 否 目标租户(地址栏租户优先)

响应

状态描述Schema
200用户名可用性检查结果service-identity/internal/handler/dto.CheckUsernameResponse
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.CheckUsernameResponse

检查用户名可用性结果

字段类型必填示例约束描述
available boolean 否 True Is available
username string 否 john_doe Username