GET /internal/thirdparty/captcha/challenge
根据指定提供者类型生成CAPTCHA挑战数据,PoW类型返回随机挑战码和难度值,Turnstile类型返回Site Key,用于前端初始化验证组件并开始人机验证流程
第三方验证 `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
provider |
query |
string |
No |
pow |
|
enum: `pow`, `turnstile` |
验证提供者类型(pow / turnstile) |
scope |
query |
string |
No |
default |
|
|
应用范围标识,用于区分不同业务页面或场景的挑战 |
difficulty |
query |
integer |
No |
|
|
|
PoW挑战难度值,数值越大计算难度越高(仅对pow类型有效) |
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 |
|
|
|