A AuthMS API Wiki API Reference iam.tianv.com →

POST /internal/thirdparty/captcha/verify

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

第三方验证 `bearerAuth` application/json

Request Body

Schema: gitee_com_linmes_authms_micro-services_thirdparty-service_internal_dto.CaptchaVerifyRequest

FieldTypeRequiredExampleConstraintsDescription
provider string Yes
token string Yes
action string No
challenge_id string No
remote_ip string No

Responses

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

Referenced Schemas

dto.DataResponse-gitee_com_linmes_authms_micro-services_thirdparty-service_internal_dto_CaptchaVerifyResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data gitee_com_linmes_authms_micro-services_thirdparty-service_internal_dto.CaptchaVerifyResponse No
message string No
timestamp string No

dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No

gitee_com_linmes_authms_micro-services_thirdparty-service_internal_dto.CaptchaVerifyResponse

FieldTypeRequiredExampleConstraintsDescription
action string No
error_codes array of

string

No
provider string No
score number No
success boolean No