POST `/auth/register/check-username`

Check if a username is already taken before user registration to prevent bulk registration and conflicts. Supports GET and POST methods. References: OWASP ASVS V2.2.

Authentication None application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`username`	`query`	`string`	No				Username (GET method)

Request Body

Schema: dto.CheckUsernameRequest

Field	Type	Required	Example	Constraints	Description
`username`	`string`	Yes	`john_doe`		Username

Responses

Status	Description	Schema
200	Username availability check result	`dto.CheckUsernameResponse`
400	Invalid request parameters	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.CheckUsernameResponse

Check username availability result

Field	Type	Required	Example	Constraints	Description
`available`	`boolean`	No	`True`		Is available
`username`	`string`	No	`john_doe`		Username

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /auth/register/check-username