POST `/internal/thirdparty/captcha/verify`

Receive the CAPTCHA token submitted by the user (PoW proof-of-work result or Turnstile verification token), call the corresponding verification provider for server-side validation, and return the verification result (pass/fail, score, and error code)

Third-party Verification `bearerAuth` application/json

Request Body

Schema: gitee_com_linmes_authms_micro-services_thirdparty-service_internal_dto.CaptchaVerifyRequest

Field	Type	Required
`provider`	`string`	Yes
`token`	`string`	Yes
`action`	`string`	No
`challenge_id`	`string`	No
`remote_ip`	`string`	No

Responses

Status	Description	Schema
200	Verification completed, returns pass/fail, score, and error code	`dto.DataResponse-gitee_com_linmes_authms_micro-services_thirdparty-service_internal_dto_CaptchaVerifyResponse`
400	Request parameter error (missing required fields or unsupported verification provider)	`dto.SimpleResponse`
429	CAPTCHA verification request too frequent, please retry later	`dto.SimpleResponse`
500	Verification service unavailable	`dto.SimpleResponse`

Referenced Schemas

dto.DataResponse-gitee_com_linmes_authms_micro-services_thirdparty-service_internal_dto_CaptchaVerifyResponse

Field	Type	Required
`code`	`integer`	No
`data`	`gitee_com_linmes_authms_micro-services_thirdparty-service_internal_dto.CaptchaVerifyResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.SimpleResponse

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

gitee_com_linmes_authms_micro-services_thirdparty-service_internal_dto.CaptchaVerifyResponse

Field	Type	Required
`action`	`string`	No
`error_codes`	array of string	No
`provider`	`string`	No
`score`	`number`	No
`success`	`boolean`	No

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

POST /internal/thirdparty/captcha/verify