Skip to content
On this page
Home
>API
>createTask: Tạo Nhiệm vụ

createTask: tạo nhiệm vụ

WARNING

Tạo một nhiệm vụ để giải quyết loại captcha được chọn.

Chỉ định loại captcha trong tham số.

Ví dụ: ImageToTextTask

Bạn có thể Xem tất cả các loại nhiệm vụ được hỗ trợ

Ví dụ yêu cầu

json
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

{
    "clientKey": "YOUR_API_KEY",
    "appId": "APP_ID",
    "task": {
        "type": "ImageToTextTask", // Ghi bên dưới loại bạn cần xác định
        "body": "BASE64 image"
    }
}

Các 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 trong bảng điều khiển
appIdStringNoAppId của nhà phát triển của bạn, đăng ký trong phần nhà phát triển của bảng điều khiển
taskObjectYesĐối tượng nhiệm vụ
callbackUrlStringNotoken sẽ được gửi (gửi) đến điểm cuối này

Ví dụ phản hồi

Ví dụ về phản hồi nhiệm vụ không đồng bộ

Khi một nhiệm vụ được tạo dưới dạng nhiệm vụ mã thông báo hoặc nhiệm vụ không đồng bộ đặc biệt, kết quả nhiệm vụ được obtained qua lệnh getTaskResult

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // Lưu ID này cho bước tiếp theo
}

Ví dụ về phản hồi nhiệm vụ đồng bộ

Nếu loại nhiệm vụ là nhận dạng hình ảnh, nhận dạng giọng nói hoặc một số nhiệm vụ đặc biệt, kết quả nhiệm vụ được trả về trực tiếp. Nó có thể được xác định bằng cách kiểm tra xem status có bằng ready hay không

json
{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "status": "ready",
    "solution": {
        "text": "44795sds"
    },
    "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b",
}

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

Tham sốKiểuMô tả
errorIdIntegerThông báo lỗi:
0 - không có lỗi
1 - có lỗi
errorCodeStringBảng mã lỗi
errorDescriptionStringMô tả lỗi
statusStringtrả về trạng thái, chỉ có thể là null hoặc ready
solutionObjectNhiệm vụ đồng bộ trả về kết quả
taskIdStringID của nhiệm vụ được tạo, Nhận kết quả nhiệm vụ