POST /v1/solve/:type
统一求解入口。需要鉴权,见 鉴权。
http
POST /v1/solve/akamai
POST /v1/solve/kasada
POST /v1/solve/datadome
POST /v1/solve/reese84路径里的 type 会转成小写。未知或不支持的 type 返回 404 NOT_FOUND。
请求体
json
{
"url": "https://example.com/",
"proxy": "",
"timeout": 30000,
"user_agent": "",
"cookie": "",
"payload": {}
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 多数必填 | 目标页。须 http:// 或 https:// |
proxy | string | 否 | 出站代理,透传给求解会话 |
timeout | number | 否 | 毫秒。默认约 90000,有上限 |
user_agent | string | 否 | 也接受驼峰 userAgent。空则用内置 Chrome UA |
cookie | string | 否 | Cookie 头快照 |
payload | object | 否 | 厂商专用参数 |
公共字段放顶层,厂商字段放 payload。各厂商细节见侧栏 厂商 文档。
超时
超过请求 timeout 返回 504:
json
{
"ok": false,
"type": "kasada",
"error": { "code": "TIMEOUT", "message": "kasada timeout after 90000ms" },
"cost_ms": 90012
}部分厂商内部还有更短的子步骤超时,最终仍收敛为 SOLVE_FAILED 或 TIMEOUT。
成功 / 失败外壳
见 约定。data 形状按厂商不同: