GET /internal/thirdparty/captcha/challenge

根据指定提供者类型生成CAPTCHA挑战数据,PoW类型返回随机挑战码和难度值,Turnstile类型返回Site Key,用于前端初始化验证组件并开始人机验证流程

第三方验证 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
provider query string 否 pow enum: `pow`, `turnstile` 验证提供者类型(pow / turnstile)
scope query string 否 default 应用范围标识,用于区分不同业务页面或场景的挑战
difficulty query integer 否 PoW挑战难度值,数值越大计算难度越高(仅对pow类型有效)

响应

状态描述Schema
200挑战生成成功,返回挑战ID、类型、挑战数据和过期时间dto.DataResponse-captcha_Challenge
400请求参数错误(不支持的验证提供者类型)dto.SimpleResponse
429CAPTCHA挑战请求过于频繁,请稍后重试dto.SimpleResponse
500挑战生成服务不可用dto.SimpleResponse

引用的 Schema

captcha.Challenge

字段类型必填示例约束描述
data captcha.ChallengeData 否
expires_at string 否
id string 否
site_key string 否
tenant_id string 否
type string 否

captcha.ChallengeData

字段类型必填示例约束描述
challenge string 否
difficulty integer 否
tenant_id string 否

dto.DataResponse-captcha_Challenge

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

dto.SimpleResponse

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