POST /internal/thirdparty/captcha/verify

接收用户提交的CAPTCHA令牌(PoW工作量证明计算结果或Turnstile验证Token),调用对应的验证提供者进行服务端校验,返回验证结果(是否通过、评分及错误码)

第三方验证 `bearerAuth` application/json

请求体

Schema: dto.CaptchaVerifyRequest

字段类型必填示例约束描述
provider string 是
token string 是
action string 否
challenge_id string 否
remote_ip string 否

响应

状态描述Schema
200验证完成,返回是否通过、评分及错误码dto.DataResponse-dto_CaptchaVerifyResponse
400请求参数错误(缺少必填字段或不支持的验证提供者)dto.SimpleResponse
429CAPTCHA验证请求过于频繁,请稍后重试dto.SimpleResponse
500验证服务不可用dto.SimpleResponse

引用的 Schema

dto.CaptchaVerifyResponse

字段类型必填示例约束描述
action string 否
error_codes array of

string

否
provider string 否
score number 否
success boolean 否

dto.DataResponse-dto_CaptchaVerifyResponse

字段类型必填示例约束描述
code integer 否
data dto.CaptchaVerifyResponse 否
message string 否
timestamp string 否

dto.SimpleResponse

字段类型必填示例约束描述
code integer 否
message string 否
timestamp string 否