Hướng dẫn
getTaskResult: Kết quả nhiệm vụ

getTaskResult: yêu cầu kết quả tác vụ

Khi tác vụ được khởi tạo bởi createTask là một tác vụ bất đồng bộ, hãy lấy kết quả tác vụ bất đồng bộ thông qua getTaskResult.

  1. Số lượng yêu cầu truy vấn tối đa cho mỗi tác vụ là 120. Khi số lượng yêu cầu truy vấn vượt quá, kết quả tác vụ sẽ bị mất.
  2. Mỗi tác vụ có thể được truy vấn trong vòng 5 phút sau khi được tạo, và sẽ bị mất sau khi thời gian vượt quá.
  3. Kết quả nhận dạng thu được bằng phương pháp này, tùy thuộc vào tải hệ thống, bạn sẽ nhận được kết quả trong khoảng thời gian từ 1s đến 30s.
WARNING

Xin lưu ý rằng không phải tất cả các tác vụ đều cần lấy kết quả theo cách này. Hai loại tác vụ sau đây cần kiểm tra tài liệu.

  • Các tác vụ nhận dạng, ví dụ ImageToText, v.v., được đồng bộ hóa trực tiếp thông qua kết quả trả về của createTask.

Ví dụ về yêu cầu

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
 
{
    "clientKey":"YOUR_API_KEY",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" //ID created by the createTask method
}

Tham số yêu cầu

Tham sốKiểuBắt buộcMô tả
clientKeystringYesKhóa tài khoản khách hàng, có thể tìm thấy tại đây
taskIdstringYesID được tạo bởi phương thức createTask

Ví dụ về phản hồi

{
    "errorId": 0,
	"taskId": "...",
    "solution": {
        "userAgent": "xxx",
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
    },
    "status": "ready"
}

Cấu trúc phản hồi

Tham sốKiểuMô tả
errorIdIntegerThông báo lỗi:
0 - không lỗi
1 - có lỗi
errorCodeStringerrorCode: danh sách đầy đủ các lỗi
errorDescriptionStringMô tả lỗi
statusString• idle - Đang chờ
• processing - Đang nhận dạng
• ready - Nhận dạng hoàn tất và kết quả được tìm thấy trong tham số solution
solutionObjectDữ liệu kết quả tác vụ. Khác nhau đối với từng loại tác vụ

Quy cách phản hồi

  • Nhận dạng thành công: Khi errorId bằng 0status bằng ready, kết quả nằm trong solution.

  • Đang nhận dạng: Khi errorId bằng 0status bằng processing, vui lòng thử lại sau 3 giây.

  • Lỗi: Khi errorId lớn hơn 0, vui lòng xem thông tin lỗi theo errorDescription.

    errorCode: danh sách đầy đủ các lỗi