GeeTest v4 解決 API：seccode 5 フィールドを取得

SolveHub API で GeeTest v4 スライドを解決し、サイトに送信する 5 つの seccode フィールドを取得。risk_type はそのまま透過し、slide のみ対応します。

許可された QA 自動化とブラウザー連携向けです。テスト権限のあるサイトと業務フローでのみ使用してください。

GeeTest v4 スライド向けで、サイトに送信する 5 つの seccode フィールドを返します。riskType が slide で始まるスライドのみ対応します。解決後も同じプロキシ出口でサイトにアクセスしてください。

リクエストフィールド

外側の type と task は必須です。以下の task.* パスは task オブジェクト内にあります。フィールド名は大文字小文字を区別します。長さ制限は UTF-8 バイトです。

フィールド	型	必須	制限	説明
`type`	文字列	はい	`geetest_v4` 固定	プラットフォームのタスク種別。
`task`	JSON オブジェクト	はい	≤ 7 MiB	この種別のタスクパラメーター。
`task.type`	文字列	いいえ	指定時は `geetest_v4` 固定	旧リクエスト形式との互換用。新規は省略可。
`task.captchaId`	文字列	はい	32 桁の 16 進数	ページ設定の `captcha_id`。
`task.riskType`	非空文字列	いいえ	≤ 512 バイト	サイトが返す `risk_type` をそのまま渡す（`
`task.sessionId`	非空文字列	いいえ	≤ 256 バイト	GeeTest `/load` に `user_info.session_id` として渡す。一部サイトで必須。
`task.lang`	非空文字列	いいえ	≤ 16 バイト	`/load` のウィジェット言語。既定は `eng`。
`task.websiteURL`	HTTP(S) URL	いいえ	≤ 2048 バイト	ページ URL。診断情報のみ。
`task.proxyType`	文字列	はい	`http` / `https` / `socks5`	プロキシプロトコル。
`task.proxyAddress`	非空文字列	はい	≤ 256 バイト	プロキシアドレス。
`task.proxyPort`	文字列	はい	1–5 バイト、値 1–65535	プロキシポート。引用符付きの数字文字列。
`task.proxyLogin`	非空文字列	いいえ	≤ 256 バイト	プロキシユーザー名。
`task.proxyPassword`	非空文字列	いいえ	≤ 256 バイト	プロキシパスワード。

作成リクエストの例

{
  "type": "geetest_v4",
  "task": {
    "captchaId": "e392e1d7fd421dc63325744d5a2b9c73",
    "riskType": "slide",
    "proxyType": "http",
    "proxyAddress": "203.0.113.10",
    "proxyPort": "8080"
  }
}

cURL での呼び出し

例の中の Key、サイト情報、プロキシを実際の値に置き換えてください。同じ業務リクエストを再試行するときは Idempotency-Key を変えないでください。

curl -sS -X POST 'https://www.tiam.codes/v1/tasks' \
  -H 'Authorization: Bearer sh_REPLACE_ME' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: example-geetest-v4-0001' \
  --data-binary @- <<'JSON'
{
  "type": "geetest_v4",
  "task": {
    "captchaId": "e392e1d7fd421dc63325744d5a2b9c73",
    "riskType": "slide",
    "proxyType": "http",
    "proxyAddress": "203.0.113.10",
    "proxyPort": "8080"
  }
}
JSON

作成レスポンスと照会

作成に成功すると HTTP 202 を返し、status は通常 queued です。taskId を保存し、約 2–3 秒ごとに GET /v1/tasks/{taskId} で照会してください。この種別の処理ソフト期限は 120 秒です。超えると uncertain になる場合がありますが、受理済みタスクの結果は引き続き確認できます。新しい冪等キーで代替タスクを作らないでください。

結果フィールド

status=completed のときだけ solution を読んでください。表はよく使うフィールドで、実際のレスポンスが正となります。

フィールド	型	読み取り方
`solution.captcha_id`	文字列	サイトの `captcha_id` をそのまま返す。
`solution.lot_number`	文字列	検証パラメーター `lot_number`。
`solution.pass_token`	文字列	検証パラメーター `pass_token`。
`solution.gen_time`	文字列	検証パラメーター `gen_time`。
`solution.captcha_output`	文字列	検証パラメーター `captcha_output`。
`solution.userAgent`	文字列	検証パラメーター送信時は同じ User-Agent を使用。

5 つの seccode フィールドをそのままサイトに送信してください。riskType に | 接尾辞がある場合は完全に渡してください。切り詰めると ERROR_BAD_PARAMETERS になります。

失敗とトラブルシューティング

riskType が slide で始まるスライドのみ対応します。成功率はプロキシ IP の評判に依存します。riskType の切り詰め、32 桁 16 進数でない captchaId、到達できないプロキシはタスクを失敗させます。

作成時のよくあるエラーは 400 INVALID_TASK、402 INSUFFICIENT_BALANCE、429 TASK_LIMIT_EXCEEDED、503 TYPE_UNAVAILABLE です。作成済みタスクの失敗時は TASK_FAILED または TASK_TIMEOUT、uncertain は TASK_UNCERTAIN に対応します。詳細はプラットフォーム API リファレンスを参照してください。

処理ウィンドウはタスク作成時から起算します。プラットフォームは約 90 秒後に未完了のタスクを放棄し、課金しません。