# getTaskResult ile sonuç alma

> POST /getTaskResult asenkron bir görevin sonucunu sorgular: her 5 saniyede bir yoklayın, processing durumunda beklemeyi sürdürün, ready durumunda solution değerini alın, hata durumunda yoklamayı durdurun; bir görev en fazla yaklaşık 110 saniye sürer, sonuçlar yaklaşık 10 dakika saklanır, sorgulama puan düşmez.

Source: https://docs.yescaptcha.com/tr/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`, asenkron bir görevin sonucunu sorgular. Görevi oluşturduktan sonra her 5 saniyede bir çağırın: `processing` dönerse beklemeye devam edin, `ready` döndüğünde sonuç `solution` içindedir, hata dönerse yoklamayı durdurun. Sorgulama için puan düşülmez; kaç kez sorgulanırsa sorgulansın aynıdır.

- POST `https://api.yescaptcha.com/getTaskResult` (Global uç nokta)
- POST `https://cn.yescaptcha.com/getTaskResult` (Çin uç noktası)

## İstek parametreleri

| Alan | Tür | Zorunlu | Açıklama |
| --- | --- | --- | --- |
| `clientKey` | string | Evet | ClientKey; görevi oluştururken kullandığınızla aynı olmalıdır |
| `taskId` | string | Evet | [createTask](https://docs.yescaptcha.com/tr/api/create-task.md) tarafından döndürülen görev ID’si |

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

## Dönen sonuç

| Durum | Yanıt | Ne yapmalı |
| --- | --- | --- |
| İşleniyor | `errorId` 0, `status` değeri `processing` | 5 saniye sonra tekrar sorgulayın |
| Tamamlandı | `errorId` 0, `status` değeri `ready`, sonuç `solution` içinde | `solution` değerini alın; alanları görev türü sayfalarında açıklanır |
| Çözülemedi | `errorId` 1, `errorCode` değeri `ERROR_CAPTCHA_UNSOLVABLE` | Puan otomatik iade edildi, yeni bir görev oluşturabilirsiniz |
| Zaman aşımı | `errorId` 1, `errorCode` değeri `ERROR_TASK_TIMEOUT` | Puan otomatik iade edildi, yeni bir görev oluşturabilirsiniz |
| Görev yok veya süresi dolmuş | `errorId` 1, `errorCode` değeri `ERROR_TASKID_INVALID` | Bu `taskId` değerini sorgulamayı bırakın |

Tamamlanmış bir görev örneği (reCAPTCHA v2):

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

## Kurallar

-   **Her 5 saniyede bir sorgulayın.** Aynı `taskId` için 5 saniye içindeki tekrar sorgular doğrudan `processing` döndürür; daha sık sorgulamak sonucu hızlandırmaz.
-   **Bir görev en fazla yaklaşık 110 saniye işlenir** (bazı türlerde 180 ile 220 saniye). Süre aşılırsa `ERROR_TASK_TIMEOUT` döner ve puan otomatik iade edilir. Kodunuzdaki bekleme üst sınırını yaklaşık 3 dakika olarak ayarlamanız önerilir.
-   **Sonuçlar yaklaşık 10 dakika saklanır**, sonrasında `taskId` geçersiz olur ve `ERROR_TASKID_INVALID` döner. Sonucu alır almaz kullanın: token’ın kendi geçerlilik süresi daha kısadır (reCAPTCHA için yaklaşık 120 saniye).
-   **Hata gelirse durun.** `errorId: 1` döndükten sonra aynı `taskId` değerini sorgulamak sonucu değiştirmez; sona ermiş bir görev 3. kez sorgulandığında `errorDescription` sonunda yoklamayı durdurmanızı öneren bir uyarı yer alır. `ERROR_TASKID_INVALID`, [otomatik duraklatma](https://docs.yescaptcha.com/tr/api/rate-limits.md) için sayılan hata sayısına dahildir (aynı ID için yalnızca ilk seferi sayılır).
-   Görevi hangi uç noktada oluşturduysanız sorguyu da o uç noktada yapın.
-   `getTaskResult` otomatik duraklatmadan etkilenmez: duraklatmadan önce oluşturulan görevler normal şekilde sorgulanabilir.