HCaptcha: hCaptcha の解決
TIP
createTaskメソッドを使用してタスクを作成し、getTaskResultメソッドを使用して結果を取得します。
TIP
ほとんどの高スコアのウェブサイトの要件を満たし、invisible
、draw 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を使用してタスクを作成します。
タスクオブジェクトの構造
プロパティ | タイプ | 必須 | 説明 |
---|---|---|---|
type | String | Required | HCaptchaTask HCaptchaTaskProxyLess |
websiteURL | String | Required | hcaptcha を使用しているウェブサイトの Web アドレス、一般的に固定値です。 (例: https://google.com) |
websiteKey | String | Required | ドメインの公開キー、めったに更新されません。 (例: b989d9e8-0d14-41sda0-870f-97b5283ba67d ) |
isInvisible | Boolean | Optional | 不可視キャプチャの場合は true を設定します |
proxy | String | Optional | プロキシの使用方法を学びます |
enterprisePayload | Object | Optional | hcaptcha Enterprise の一部の実装で使用されるカスタムデータ。 したがって、isEnterprise パラメーターに true を設定する必要があります。ほとんどの場合、ネットワークリクエスト内の rqdata として表示されます。重要: data パラメーターでキャプチャを送信する場合は、userAgent を必ず提供する必要があります。 値は、対象のウェブサイトとの対話時に使用する User-Agent と一致する必要があります。 |
getCaptcha | Object | Optional | 無効な応答を受け取った場合は、このパラメーターを試すことができます。HCaptcha のバイパスで学ぶことができます |
userAgent | String | Optional | エミュレーションで使用されるブラウザの 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",
})