API previewv0.1/Updated 2026-11-13

一个同步接口，
直接拿结果。

通过统一的产品与 Action 路径调用不同验证挑战。所有响应都带 request_id、trace_id 和 cost_time，便于对账和排障。

HTTPSRESTJSONBearer authIdempotent

快速开始

Base URL：https://api.ocaptcha.com/v1

Send a synchronous request

curl -X POST "https://api.ocaptcha.com/v1/cloudflare/turnstile" \
  -H "Authorization: Bearer oc_live_..." \
  -H "Content-Type: application/json" \
  -H "X-Request-ID: 6e8e7a60-..." \
  --data-raw '{
    "url": "https://owned.example.invalid/login",
    "site_key": "YOUR_SITE_KEY",
    "user_agent": "Mozilla/5.0 ... Chrome/146.0.0.0",
    "proxy": "http://user:pass@proxy.example:8080"
  }'

身份验证

所有产品请求和余额查询都使用 API Key。密钥通过 Authorization Header 传递，不要放在 URL、前端包或公开仓库中。

Authorization: Bearer oc_live_...

发送请求

Endpoint

POST /v1/{product}/{action}

English alias

POST /e/v1/{product}/{action}

X-Request-ID：可传 UUID，重复 ID 会被拒绝，避免重复扣费。

X-Timeout-Ms：设置等待上限，不能突破产品与平台上限。

X-Locale：可选 zh 或 en，只影响提示语言。

产品与 Action

同一产品可能有多个执行路径，费用、线程和代理要求不同。

打开调试台

Product	Action	Result	Proxy
Cloudflare	challenge	代理会话	必须代理
Cloudflare	turnstile	Token	可选代理
Cloudflare	turnstile_proxyless	Token	内置出口
Incapsula	execute	会话执行	按目标配置
Kasada	cd / payload / tl	分步任务	按权重计费
DataDome	jspl / solve	分步任务	按目标配置
Akamai	sensor / bmp	多步任务	企业适配

响应结构

{
  "code": "OK",
  "message": "成功",
  "request_id": "req_4K7R9D2",
  "trace_id": "trace_91MD4CQ",
  "cost_time": 2140,
  "result": {
    "token": "<TOKEN>",
    "verified": true
  }
}

接口返回 OK 只代表网关完成了任务；目标站点是否接受 token、Cookie 或 payload，仍需由客户自己的流程验证。

错误码

Code	HTTP	Meaning
UNAUTHORIZED	401	密钥无效或已被撤销
KEY_NOT_BOUND	403	密钥未绑定该产品或余额计费
CONFLICT	409	重复 request_id，已拒绝重复执行
RATE_LIMITED	429	超过套餐入口速率
CONCURRENCY_LIMIT	429	套餐并发已满
QUOTA_EXHAUSTED	429	套餐可用额度不足
ENTITLEMENT_EXPIRED	403	权益已到期
DEADLINE_EXCEEDED	504	超过请求期限

计费与限制

只计最终成功

失败、取消、超时不扣次。余额计费按受理时公布的 Action 单价结算。

套餐与余额

次数包按购买时的 Action 权重扣次；并发包在有效期内不限次数，只受线程和入口速率限制。

密钥绑定权益

一把密钥可以绑定多个产品；多把密钥共享权益时，额度、并发和速率一起共享。

请求级对账

通过 request_id 查询结算状态。传输失败时先核对结果，不要直接换 ID 重放。

查询余额

任何启用的 API Key 都可以查询账户余额，无需登录，不扣费。金额以 USDT 六位小数微单位字符串返回。

GET /v1/balance

curl "https://api.ocaptcha.com/v1/balance" \
  -H "Authorization: Bearer oc_live_..."

Response

{
  "code": "OK",
  "result": {
    "asset": "USDT",
    "decimals": 6,
    "balance": "10000000",
    "reserved": "10000",
    "available": "9990000"
  }
}

需要企业级目标适配？

企业客户可以获得目标验收、专属资源和上线支持。

联系团队

一个同步接口，直接拿结果。