getTaskResult 結果の取得

getTaskResult は非同期タスクの結果を取得します。タスクの作成後、5 秒ごとに呼び出してください。processing が返ったら待機を続け、ready が返ったら結果は solution に入っています。エラーが返ったらポーリングを止めます。問い合わせに課金はなく、何回呼び出しても同じです。

POSThttps://api.yescaptcha.com/getTaskResultグローバルエンドポイントコピー

POSThttps://cn.yescaptcha.com/getTaskResult中国エンドポイントコピー

リクエストパラメータ

フィールド	型	必須	説明
clientKey	string	はい	タスク作成時に使ったものと同じ clientKey
taskId	string	はい	createTask が返したタスク ID

{
  "clientKey": "YOUR_CLIENT_KEY",
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

レスポンス

状況	レスポンス	対応
処理中	errorId が 0、status が processing	5 秒後に再度問い合わせる
完了	errorId が 0、status が ready、結果は solution に入っている	solution を読み取る。フィールドは各タスクタイプのページを参照
認識失敗	errorId が 1、errorCode が ERROR_CAPTCHA_UNSOLVABLE	自動的に返金済み。新しくタスクを作成できる
タイムアウト	errorId が 1、errorCode が ERROR_TASK_TIMEOUT	自動的に返金済み。新しくタスクを作成できる
タスクが存在しない、または期限切れ	errorId が 1、errorCode が ERROR_TASKID_INVALID	この taskId の問い合わせを止める

完了時の例（reCAPTCHA v2）:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnU..."
  }
}

ルール

• 5 秒ごとに問い合わせてください。 同じ taskId への 5 秒以内の再問い合わせには、すぐに processing が返ります。頻繁に問い合わせても結果は早くなりません。
• タスクの処理時間は最長で約 110 秒です（一部のタイプは 180〜220 秒）。超過すると ERROR_TASK_TIMEOUT が返り、自動的に返金されます。プログラム側の待機の上限は 3 分程度に設定することをお勧めします。
• 結果の保持期間は約 10 分です。 その後は taskId が無効になり、ERROR_TASKID_INVALID が返ります。結果は取得したらすぐに使用してください。token 自体の有効期間はさらに短くなります（reCAPTCHA は約 120 秒）。
• エラーが返ったら止めてください。 errorId: 1 が返った後に同じ taskId を問い合わせ続けても結果は変わりません。終了済みの同じタスクを 3 回目に問い合わせると、errorDescription の末尾にポーリングを止めるよう促すメッセージが付きます。ERROR_TASKID_INVALID は、自動一時停止の対象となるエラー回数に含まれます（同じ ID は最初の 1 回のみ数えます）。
• タスクを作成したエンドポイントと同じエンドポイントで問い合わせてください。
• getTaskResult は自動一時停止の影響を受けません。一時停止の前に作成したタスクは、これまでどおり問い合わせできます。