API başvurusu

getTaskResult ile sonuç alma

Bu sayfa Çince sürümden makine çevirisiyle hazırlanmıştır ve hatalar içerebilir. Geçerli olan Çince sürüm sürümüdür.

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.

POSThttps://api.yescaptcha.com/getTaskResultGlobal uç nokta

POSThttps://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 tarafından döndürülen görev ID’si

{
  "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):

{
  "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 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.