← 返回 CloudflareAPI documentation

清晰输入,明确终态。

所有求解请求使用 X-API-Key 鉴权,每次受理预扣 1 个额度,超时失败自动退回。响应同时返回剩余额度,Key 的完整值只在创建时显示一次。

POST/solver/v1/solve/page

页面级 Challenge

处理目标 URL 的 Managed Challenge,并按需在同一 Session 重新 GET 页面验证。

必填
url
可选
proxy cookies allow_interactive
终态
complete_token + cf_clearance
POST/solver/v1/solve/embedded

内嵌 Turnstile

处理业务页面中的组件参数,可选预取父页面并先处理外层 Challenge。

必填
url sitekey
可选
action cData chlPageData
终态
complete_token callback token

登录后使用在线测试台

接口文档与请求示例可直接查看。

登录并进入测试台 →
Quick start

请求示例

使用控制台中保存的完整 Key。服务还会返回 X-RateLimit-Limit 与 X-RateLimit-Remaining。

Python
import requests

response = requests.post(
    "https://your-host/solver/v1/solve/page",
    headers={"X-API-Key": "capi_live_..."},
    json={
        "url": "https://codeforces.com/enter",
        "allow_interactive": True,
        "verify_page": True,
    },
    timeout=240,
)
response.raise_for_status()
print(response.json()["complete_token"])