ガイド
タスク(トークン)
hCaptcha

HCaptcha: hCaptcha の解決

TIP

createTaskメソッドを使用してタスクを作成し、getTaskResultメソッドを使用して結果を取得します。

TIP

ほとんどの高スコアのウェブサイトの要件を満たし、invisibledraw a boxなどの質問タイプもサポートしています

サポートするタスクのtypes

  • HCaptchaTask このタスクタイプには独自のプロキシが必要です
  • HCaptchaTaskProxyLess サーバーの組み込みプロキシを使用します
hCaptcha のサービス不安定に関するお知らせ

最近の hCaptcha のサービスの不安定について、画像の更新やその他の問題が原因でお客様にご不便をおかけしましたことをお詫び申し上げます。新しい画像によりサービスが利用できなくなる場合は、弊社の更新をお待ちください。その他のご質問がございましたら、いつでもお気軽にお問い合わせください。

`HCaptchaTask`を使用して無効な応答を受け取った場合は、お問い合わせください

各ウェブサイトには特定の設定があり、通常、設定した後に正常に機能します。

トークンの成功率を確保するために、固定の UserAgent を使用してください

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36 (更新がいつでも発生する可能性があるため、注意してください。)

タスクの作成

createTaskを使用してタスクを作成します。

タスクオブジェクトの構造

プロパティタイプ必須説明
typeStringRequiredHCaptchaTask
HCaptchaTaskProxyLess
websiteURLStringRequiredhcaptcha を使用しているウェブサイトの Web アドレス、一般的に固定値です。 (例: https://google.com)
websiteKeyStringRequiredドメインの公開キー、めったに更新されません。 (例: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
isInvisibleBooleanOptional不可視キャプチャの場合は true を設定します
proxyStringOptionalプロキシの使用方法を学びます
enterprisePayloadObjectOptionalhcaptcha Enterprise の一部の実装で使用されるカスタムデータ。
したがって、isEnterprise パラメーターに true を設定する必要があります。ほとんどの場合、ネットワークリクエスト内のrqdataとして表示されます。
重要: dataパラメーターでキャプチャを送信する場合は、userAgentを必ず提供する必要があります。
値は、対象のウェブサイトとの対話時に使用する User-Agent と一致する必要があります。
getCaptchaObjectOptional無効な応答を受け取った場合は、このパラメーターを試すことができます。HCaptcha のバイパスで学ぶことができます
userAgentStringOptionalエミュレーションで使用されるブラウザの User-Agent。現代のブラウザの署名を使用する必要があり、そうでない場合、Google から「ブラウザを更新してください」との要求が表示されます。

例のリクエスト

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    //必須. HCaptchaTaskProxylessまたはHCaptchaTaskを使用できます
    "type": "HCaptchaTaskProxyLess",
    //必須
    "websiteURL": "",
    // 必須
    "websiteKey": "00000000-0000-0000-0000-000000000000",
    // オプション
    "isInvisible": true,
    // オプション
    "enterprisePayload": {
      //オプション, サイトにHCaptcha Enterpriseがある場合は必要
      "rqdata": ""
    },
    //オプション, これはHCaptchaTaskを使用する場合に必要です
    "proxy": "http:ip:port:user:pass",
    // socks5:ip:port:user:pass
    //オプション
    "getCaptcha": "fetch request base64 content",
    "userAgent": ""
  }
}

タス

クを私たちに送信した後、成功した場合は応答で ‘タスク ID’ を受け取るはずです。タスク ID が受信されなかった場合は、エラーコード: エラーの完全なリストを読んでください。

例のレスポンス

{
  "errorId": 0,
  "errorCode": "",
  "errorDescription": "",
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

結果の取得

認識結果を取得するために getTaskResult メソッドを使用します

システムの負荷に応じて、結果を取得する間隔は 1秒 から 10秒 の間です。

例のリクエスト

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
 
{
    "clientKey": "YOUR_API_KEY",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

例のレスポンス

{
  "errorId": 0,
  "errorCode": null,
  "errorDescription": null,
  "solution": {
    //キャプチャを解決するために使用されたuserAgent
    "userAgent": "xxx",
    //トークンの有効期限
    "expireTime": 1671615324290,
    "timestamp": 1671615024290,
    "captchaKey": "E0_xxx",
    //キャプチャのトークン
    "gRecaptchaResponse": "3AHJ....."
  },
  "status": "ready"
}

SDK リクエストの使用

# pip install --upgrade capsolver
# export CAPSOLVER_API_KEY='...'
 
import capsolver
 
# capsolver.api_key = "..."
solution = capsolver.solve({
    "type": "HCaptchaTaskProxyLess",
    "websiteURL": "",
    "websiteKey": "00000000-0000-0000-0000-000000000000",
})