API / V1

调用说明

只支持 hCaptcha。每次成功返回一个 P1_ token，失败不扣用户额度。

在 Authorization 请求头中传入用户 API Key。

Authorization: Bearer hc_your_user_key

提交求解

POST /api/v1/token

curl -X POST https://YOUR_HOST/api/v1/token \
  -H "Authorization: Bearer hc_your_user_key" \
  -H "Content-Type: application/json" \
  -d '{"site_key":"f5ab1c2d-7e8f-4a9b-b1c2-d3e4f5a6b7c8","page_url":"https://target.example/login","network_proxy":"http://user:pass@proxy.example:8080"}'

请求参数

`site_key`required	hCaptcha 站点的 UUID sitekey。
`page_url`required	出现验证码的公开页面 URL。
`network_proxy`	可选。公开可访问的代理 URL，或 host/port/scheme/username/password 对象。
`rqdata`	可选。hCaptcha 的 rqdata；站点提供时传入每次挑战对应的新鲜值。

成功响应

{"state":"ready","site_key":"...","page_url":"https://...","captcha_token":"P1_...","response_key":"E0_...","browser_ua":"Mozilla/5.0 ..."}

目标站点可能要求 token 提交时使用与求解相同的代理出口 IP。

错误与额度

成功得到 token 才扣 1 次额度；处理中临时占用 1 次。

请求最多等待约 180 秒。超时、上游失败或没有 P1_ token 时返回通用错误，不暴露上游任务和响应。

`401`	`unauthorized`
`402`	`quota_exhausted`
`422`	`invalid_request`
`502`	`solve_failed`

查询额度

curl https://YOUR_HOST/api/v1/me \
  -H "Authorization: Bearer hc_your_user_key"