# getTaskResult ดึงผลลัพธ์

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

Source: https://docs.yescaptcha.com/th/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` (endpoint ทั่วโลก)
- POST `https://cn.yescaptcha.com/getTaskResult` (endpoint จีน)

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

| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
| --- | --- | --- | --- |
| `clientKey` | string | ใช่ | ClientKey ของคุณ ใช้ค่าเดียวกับที่ใช้สร้างงาน |
| `taskId` | string | ใช่ | ID งานที่ [createTask](https://docs.yescaptcha.com/th/api/create-task.md) คืนมา |

```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` จะมีข้อความแนะนำให้หยุด polling `ERROR_TASKID_INVALID` นับรวมในจำนวนข้อผิดพลาดของ [หยุดชั่วคราวอัตโนมัติ](https://docs.yescaptcha.com/th/api/rate-limits.md) (ID เดียวกันนับเฉพาะครั้งแรก)
-   สร้างงานที่ endpoint ใด ให้ตรวจสอบที่ endpoint นั้น
-   `getTaskResult` ไม่ได้รับผลจากการหยุดชั่วคราวอัตโนมัติ: งานที่สร้างไว้ก่อนการหยุดชั่วคราวยังตรวจสอบได้ตามปกติ