GET /internal/thirdparty/captcha/challenge

Generate CAPTCHA challenge data based on the specified provider type. PoW returns a random challenge code and difficulty value; Turnstile returns a Site Key for frontend initialization of the verification component and starting the human verification process.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
provider	query	string	No	pow		enum: `pow`, `turnstile`	Verification provider type (pow / turnstile)
scope	query	string	No	default			Application scope identifier, used to distinguish challenges for different business pages or scenarios
difficulty	query	integer	No				PoW challenge difficulty value; higher values increase computational difficulty (only valid for pow type)

Responses

Status	Description	Schema
200	Challenge generated successfully, returns challenge ID, type, challenge data, and expiration time	dto.DataResponse-captcha_Challenge
400	Request parameter error (unsupported verification provider type)	dto.SimpleResponse
429	CAPTCHA challenge request too frequent, please retry later	dto.SimpleResponse
500	Challenge generation service unavailable	dto.SimpleResponse

Referenced Schemas

captcha.Challenge

Field	Type	Required	Example	Constraints	Description
data	captcha.ChallengeData	No
expires_at	string	No
id	string	No
site_key	string	No
type	string	No

captcha.ChallengeData

Field	Type	Required	Example	Constraints	Description
challenge	string	No
difficulty	integer	No

dto.DataResponse-captcha_Challenge

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	captcha.Challenge	No
message	string	No
timestamp	string	No

dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No