Edit

HcaptchaImageTask

hCaptcha còn được gọi là captcha TÔI KHÔNG PHẢI ROBOT, hCaptcha là một loại hình ảnh xác thực rất phổ biến trông giống thế nay:

1. Tạo yêu cầu

Request

POST : https://api.omocaptcha.com/v2/createTask

Name
Type
Required
Description

clientKey

String

yes

Khóa tài khoản khách hàng

task.type

String

yes

Tên class dịch vụ captcha cần giải

task.anchors

String

yes

Mảng các hình ảnh captcha phần tiêu đề được mã hoá thành base64 (nếu có, không có thì truyền mảng rỗng)

task.queries

String

yes

Mảng các hình ảnh captcha được mã hoá thành base64 (nếu là dạng grid thì truyền 9 ảnh theo thứ tự trên DOM, dạng canvas thì truyền 1 ảnh)

task.question

String

yes

Câu hỏi của thử thách captcha

{
    "clientKey": "API_KEY",
    "task": {
        "type": "HcaptchaImageTask",
        "anchors": ["base64_image_1", "base64_image_2",...],
        "queries": ["base64_image_1", "base64_image_2",...],
        "question": "Pick all the cooking utensils and equipment"
    }
}

Response

{
    "errorId": 0,
    "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}

  • Máy chủ sẽ trả về errorId = 0 và taskId thành công

2a. Nhận kết quả yêu cầu (dạng Grid)

Request

POST : https://api.omocaptcha.com/v2/getTaskResult

{
    "clientKey": "API_KEY",
    "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}

Response

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "status": "ready",
    "solution": {
        "objects": [
            1,
            3,
            8
        ]
    }
}

  • Máy chủ sẽ trả về errorId = 0 và status = ready

  • Đọc kết quả trong solution

2b. Nhận kết quả yêu cầu (dạng click canvas)

Request

POST : https://api.omocaptcha.com/v2/getTaskResult

{
    "clientKey": "API_KEY",
    "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}

Response

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "status": "ready",
    "solution": {
        "type": "click",
        "coords": [
            [
                398,
                347
            ]
        ]
    }
}

  • Máy chủ sẽ trả về errorId = 0 và status = ready

  • Đọc kết quả trong solution

2c. Nhận kết quả yêu cầu (dạng kéo miếng ghép canvas)

Request

POST : https://api.omocaptcha.com/v2/getTaskResult

{
    "clientKey": "API_KEY",
    "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}

Response

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "status": "ready",
    "solution": {
        "type": "drag",
        "box": [
            {
                "start": [
                    446,
                    200
                ],
                "end": [
                    100,
                    224
                ]
            },
            {
                "start": [
                    455,
                    300
                ],
                "end": [
                    139,
                    190
                ]
            }
        ]
    }
}

  • Máy chủ sẽ trả về errorId = 0 và status = ready

  • Đọc kết quả trong solution

PrevioushCaptchaNextFunCaptcha

Last updated