# getTaskResult 結果の取得

> POST /getTaskResult は非同期タスクの結果を取得します。5 秒ごとに問い合わせ、processing の間は待機、ready になったら solution を読み取り、エラーが返ったらポーリングを止めます。タスクの処理時間は最長で約 110 秒、結果の保持期間は約 10 分で、問い合わせに課金はありません。

Source: https://docs.yescaptcha.com/ja/api/get-task-result/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/api/get-task-result/

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

- POST `https://api.yescaptcha.com/getTaskResult` (グローバルエンドポイント)
- POST `https://cn.yescaptcha.com/getTaskResult` (中国エンドポイント)

## リクエストパラメータ

| フィールド | 型 | 必須 | 説明 |
| --- | --- | --- | --- |
| `clientKey` | string | はい | タスク作成時に使ったものと同じ `clientKey` |
| `taskId` | string | はい | [createTask](https://docs.yescaptcha.com/ja/api/create-task.md) が返したタスク ID |

```json
{
  "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）:

```json
{
  "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` は、[自動一時停止](https://docs.yescaptcha.com/ja/api/rate-limits.md)の対象となるエラー回数に含まれます（同じ ID は最初の 1 回のみ数えます）。
-   タスクを作成したエンドポイントと同じエンドポイントで問い合わせてください。
-   `getTaskResult` は自動一時停止の影響を受けません。一時停止の前に作成したタスクは、これまでどおり問い合わせできます。