注册

API 文档

验证码处理服务 API 使用指南

快速开始

3 步完成验证码处理：提交任务 → 轮询结果 → 使用 Token

Base URL

https://passxapi.com

认证方式

所有 API 请求需要在 Header 中携带 API Key：

x-api-key: your_api_key_here

前往 API Key 管理 获取你的密钥。

API 端点

调用流程分为三步：提交任务 → 轮询结果 → 使用返回数据。展开每一步查看详情。

1
提交任务POST /task/submit

提交验证码处理任务，返回 task_id 用于轮询结果。

请求参数

请求示例 (hCaptcha)

curl -X POST https://passxapi.com/task/submit \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "task_type": "hcaptcha",
    "proxy": "http://user:pass@ip:port",
    "target_url": "https://example.com/login",
    "site_key": "your-site-key"
  }'

响应

{
  "ok": true,
  "task_id": "abc123-def456"}
2
轮询结果GET /task/result/{task_id}

根据 task_id 轮询任务执行结果，建议每 1-2 秒轮询一次。

状态说明

示例代码

curl https://passxapi.com/task/result/abc123-def456 \
  -H "x-api-key: YOUR_API_KEY"

成功响应示例

{
  "status": "SUCCESS",
  "result": {
    "token": "P0_eyJ...",
    "ua": "Mozilla/5.0 ...",
    "cookies": { "cf_clearance": "xxx"}
  }
}
3
使用返回数据

任务成功后，result 中会返回 token、cookies、ua 等字段，直接将它们带入你的目标网站请求即可。

# result 包含 token / cookies / ua，直接用于目标请求
import requests

result = {
    "token": "P0_eyJ...",
    "ua": "Mozilla/5.0 ...",
    "cookies": {"cf_clearance": "xxx"}
}

# 将获取到的 token 用于目标网站请求
resp = requests.post(
    "https://example.com/login",
    headers={
        "User-Agent": result["ua"],
        "Content-Type": "application/x-www-form-urlencoded"
    },
    cookies=result.get("cookies", {}),
    data={
        "username": "your_username",
        "password": "your_password",
        "captcha_token": result["token"]
    }
)

print(resp.status_code, resp.text[:200])

完整调用示例

# -*- coding: utf-8 -*-
import requests
import time

BASE_URL = "https://passxapi.com"
API_KEY = "your_api_key_here"

def solve_captcha(task_type, proxy, target_url, **kwargs):
    """提交任务并等待结果"""
    headers = {
        "Content-Type": "application/json",
        "x-api-key": API_KEY
    }

    payload = {
        "task_type": task_type,
        "proxy": proxy,
        "target_url": target_url,
        **kwargs
    }

    # 1. 提交任务
    resp = requests.post(f"{BASE_URL}/task/submit", headers=headers, json=payload, timeout=30)
    data = resp.json()
    if not data.get("ok"):
        print(f"提交失败: {data}")
        return None

    task_id = data["task_id"]
    print(f"Task ID: {task_id}")

    # 2. 轮询结果
    for _ in range(60):
        r = requests.get(f"{BASE_URL}/task/result/{task_id}", headers={"x-api-key": API_KEY}, timeout=30)
        result = r.json()

        if result["status"] == "SUCCESS":
            return result["result"]
        elif result["status"] == "FAILED":
            print(f"失败: {result.get('error')}")
            return None

        time.sleep(1)

    print("超时")
    return None

# 示例: 处理 hCaptcha
result = solve_captcha(
    task_type="hcaptcha",
    proxy="http://user:pass@ip:port",
    target_url="https://example.com/login",
    site_key="your-site-key"
)

if result:
    print(f"Token: {result['token'][:50]}...")
    print(f"UA: {result['ua']}")

错误码

RCreCAPTCHA v3recaptcha_v3热门▶

多用于中小网站、表单提交、登录注册页

请求参数

请求示例

POST /task/submit
{
  "task_type": "recaptcha_v3",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "site_key": "6Lcyqq8oAAAAAJE7eV...",
  "action": "demo_action",
  "title": "Page Title",
  "enterprise": false
}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "token": "P0_eyJ...",
    "ua": "Mozilla/5.0 ..."}
}

支持站点

GoogleYouTubeLinkedInTwitchEAEpic GamesDiscordWordPress+7
HhCaptchahcaptcha热门▶

多用于注重隐私的网站，Cloudflare 默认验证码替代方案

请求参数

请求示例

POST /task/submit
{
  "task_type": "hcaptcha",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "site_key": "6660d4df-1884-4ac6-..."}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "token": "P0_eyJ...",
    "ua": "Mozilla/5.0 ..."}
}

支持站点

CloudflareDiscordEpic GamesCoinbaseNordVPNHostingerBetMGMBrave+4
CFCloudflare Turnstilecloudflare_turnstile热门▶

多用于 Cloudflare 托管的各类网站，无感验证体验

请求参数

请求示例

POST /task/submit
{
  "task_type": "cloudflare_turnstile",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "site_key": "0x4AAAAAAABS7TtLxs..."}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "token": "P0_eyJ...",
    "ua": "Mozilla/5.0 ..."}
}

支持站点

CloudflareDHLNotionCanvaVercelGitLabFigmaHubSpot+4
AKAkamai Bot Managerakamai▶

多用于航空公司、零售电商、票务、银行

请求参数

请求示例

POST /task/submit
{
  "task_type": "akamai",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "akamai_js_url": "https://example.com/WGlx/lc_w/...",
  "page_fp": "424541475255414d424b..."}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

NikeAdidasDelta AirlinesUnited AirlinesUSPSHome DepotMarriottCostco+6
AKAkamai sec_cptakamai_sec_cpt▶

Akamai 二次验证页，同行业可疑流量触发的更严挑战

请求参数

请求示例

POST /task/submit
{
  "task_type": "akamai_sec_cpt",
  "sec_cpt": "ADE36B02B21573BD...",
  "sec_json": {
    "nonce": "30cc8a4637ca...",
    "difficulty": 5000,
    "token": "AAQAAAAL_____...",
    "count": 10,
    "timestamp": 1758097163
  }
}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

NikeAdidasDelta AirlinesHiltonFoot LockerJCPenneyNordstromTicketmaster+2
PXPerimeterX 无感perimeterx_silent▶

多用于电商、球鞋、房产、招聘平台

请求参数

请求示例

POST /task/submit
{
  "task_type": "perimeterx_silent",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "perimeterx_js_url": "https://example.com/px/PXu6b0qd2S/init.js",
  "pxAppId": "PXu6b0qd2S"}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

ZillowCraigslistIndeedStockXPoshmarkZipRecruiterWayfairChegg+4
PXPerimeterX 验证perimeterx_challenge▶

PerimeterX 触发人机验证时的交互挑战页

请求参数

请求示例

POST /task/submit
{
  "task_type": "perimeterx_challenge",
  "proxy": "http://user:pass@ip:port",
  "pxvid": "84439b81-676a-...",
  "pxuuid": "1d90e990-982a-...",
  "target_url": "https://example.com",
  "pxAppId": "PXu6b0qd2S",
  "perimeterx_js_url": "https://client.px-cloud.net/.../main.min.js",
  "captcha_js_url": "https://example.com/px/.../captcha/captcha.js",
  "init_cookies": {
    "pxhd": "3a72e00e1ce54a44..."}
}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

ZillowCraigslistIndeedStockXWayfairCheggRedfinGlassdoor+2
KSKasada ctkasada_ct▶

多用于票务、流媒体、博彩平台

请求参数

请求示例

POST /task/submit
{
  "task_type": "kasada_ct",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "protected_api_domain": "example.com",
  "kasada_js_domain": "example.com"}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

Kickbet365DraftKingsFanDuelTwitchPlayStationAfterpayCanada Goose+2
KSKasada cdkasada_cd▶

Kasada 高级防护模式，加密挑战更强

请求参数

请求示例

POST /task/submit
{
  "task_type": "kasada_cd",
  "ct": "0b3jqi5b3LjWE63t...",
  "st": "1756879688265",
  "fc": "eyJmZWF0dXJlRmxh...",
  "site": "example"}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

Kickbet365DraftKingsFanDuelPlayStationCanada GooseTelstraJetstar+2
DDDataDome 无感datadome_silent▶

多用于欧洲电商、分类广告、媒体平台

请求参数

请求示例

POST /task/submit
{
  "task_type": "datadome_silent",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "target_method": "GET"}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

RedditAllTrailsLeboncoinRakutenSoundCloudTripAdvisorVintedAxel Springer+4
SHShape Securityshape▶

多用于银行、金融机构、大型航空公司

请求参数

请求示例

POST /task/submit
{
  "task_type": "shape",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com/login/",
  "target_api": "https://example.com/api/submit",
  "shape_js_url": "https://example.com/shape.js?single",
  "method": "POST",
  "title": "Login Page"}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

Southwest AirlinesAlaska AirlinesStarbucksCitibankCapital OneMacy'sGapUnder Armour+4
FCFuncaptchafuncaptcha▶

多用于社交平台登录、游戏账号注册

请求参数

请求示例

POST /task/submit
{
  "task_type": "funcaptcha",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "custom_api_host": "xxx-api.arkoselabs.com",
  "public_key": "32FBE3BC-228C-4967-..."}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "token": "P0_eyJ...",
    "ua": "Mozilla/5.0 ..."}
}

支持站点

Microsoft / OutlookRobloxEA SportsGitHubSnapchatLinkedInAdobeTwitter / X+4
VCVercel Challengevercel_challenge▶

多用于 Vercel 部署的 SaaS 和开发者站点

请求参数

请求示例

POST /task/submit
{
  "task_type": "vercel_challenge",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com"}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

VercelNext.js 应用TikTok WebHashnodeCal.comDub.coLoomNeon+2
CTCastlecastle▶

多用于 SaaS 平台账号防护、反欺诈

请求参数

请求示例

POST /task/submit
{
  "task_type": "castle",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "config_json": {
    "pk": "pk_1Tt6Yzr1WFzx...",
    "avoidCookies": true
  }
}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "request_token": "eyJ...",
    "ua": "Mozilla/5.0 ..."}
}

支持站点

CartaGustoPlaidMercuryLatticeBrexRampAngelList+2
R84Reese84reese84▶

多用于金融、政府、企业门户网站

请求参数

请求示例

POST /task/submit
{
  "task_type": "reese84",
  "proxy": "http://user:pass@ip:port",
  "reese84_js_url": "https://example.com/reese84-script"}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

GlassdoorWestern UnionSiemensSingapore AirlinesTurkish AirlinesYamahaHSBCAIG+2
UTUTMVCutmvc▶

Imperva 旧版防护，多用于企业/政府站点

请求参数

请求示例

POST /task/submit
{
  "task_type": "utmvc",
  "proxy": "http://user:pass@ip:port",
  "utmvc_js_url": "https://example.com/_Incapsula_Resource?SWJIYLWA=...",
  "incap_cookie": {
    "visid_incap_xxx": "...",
    "nlbi_xxx": "...",
    "incap_ses_xxx": "..."}
}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

GlassdoorIndeedKrogerAutoTraderCars.comTruliaEdmundsTripAdvisor+2
SBSbsdsbsd▶

多用于 Ticketmaster 等票务平台

请求参数

请求示例

POST /task/submit
{
  "task_type": "sbsd",
  "proxy": "http://user:pass@ip:port",
  "target_url": "https://example.com",
  "sbsd_js_url": "https://example.com/NAOAvP/g/p/...",
  "init_cookies": {
    "bm_s": "...",
    "bm_sc": "..."}
}

响应示例

JSON
{
  "status": "SUCCESS",
  "result": {
    "cookies": {
      "cookie_name": "value"},
    "ua": "Mozilla/5.0 ..."}
}

支持站点

StubhubTicketmasterVivid SeatsSeatGeekAXSEventbriteLive NationTicketek+2