getTaskResult ดึงผลลัพธ์

getTaskResult ใช้ตรวจสอบผลลัพธ์ของงานแบบอะซิงโครนัส หลังสร้างงานแล้วให้เรียกทุก 5 วินาที: หากได้ processing ให้รอต่อ หากได้ ready ผลลัพธ์จะอยู่ใน solution และหากได้ข้อผิดพลาดให้หยุด การตรวจสอบไม่หักพอยต์ ไม่ว่าจะเรียกกี่ครั้งก็ตาม

POSThttps://api.yescaptcha.com/getTaskResultendpoint ทั่วโลกคัดลอก

POSThttps://cn.yescaptcha.com/getTaskResultendpoint จีนคัดลอก

พารามิเตอร์คำขอ

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
clientKey	string	ใช่	ClientKey ของคุณ ใช้ค่าเดียวกับที่ใช้สร้างงาน
taskId	string	ใช่	ID งานที่ createTask คืนมา

{
  "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 จะมีข้อความแนะนำให้หยุด polling ERROR_TASKID_INVALID นับรวมในจำนวนข้อผิดพลาดของ หยุดชั่วคราวอัตโนมัติ (ID เดียวกันนับเฉพาะครั้งแรก)
• สร้างงานที่ endpoint ใด ให้ตรวจสอบที่ endpoint นั้น
• getTaskResult ไม่ได้รับผลจากการหยุดชั่วคราวอัตโนมัติ: งานที่สร้างไว้ก่อนการหยุดชั่วคราวยังตรวจสอบได้ตามปกติ