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.
- 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.
- 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á.
- 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ểu | Bắt buộc | Mô tả |
---|---|---|---|
clientKey | string | Yes | Khóa tài khoản khách hàng, có thể tìm thấy tại đây |
taskId | string | Yes | ID đượ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ểu | Mô tả |
---|---|---|
errorId | Integer | Thông báo lỗi: 0 - không lỗi 1 - có lỗi |
errorCode | String | errorCode: danh sách đầy đủ các lỗi |
errorDescription | String | Mô tả lỗi |
status | String | • 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 |
solution | Object | Dữ 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ằng0
vàstatus
bằngready
, kết quả nằm trongsolution
. -
Đang nhận dạng: Khi
errorId
bằng0
vàstatus
bằngprocessing
, vui lòng thử lại sau 3 giây. -
Lỗi: Khi
errorId
lớn hơn0
, vui lòng xem thông tin lỗi theoerrorDescription
.