GeetestSelectObjectTask

Captcha select object là một loại hình ảnh xác thực phổ biến. Người dùng cần chọn các ô hình ảnh trùng khớp với chủ đề được yêu cầu (anchor).

1. Tạo yêu cầu

Request

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

Tham số	Kiểu	Bắt buộc	Mô tả
`clientKey`	`String`	✅	Khóa tài khoản khách hàng
`task.type`	`String`	✅	`GeetestSelectObjectTask`
`task.imageBase64`	`String`	✅	Hình ảnh lưới 3×3 được mã hóa base64
`task.question`	`String`	✅	Câu hỏi của captcha (ví dụ: `Select 3 images with`)
`task.anchor`	`String`	✅	Ảnh anchor

curl -X POST https://api.omocaptcha.com/v2/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "OMO_API_KEY",
    "task": {
      "type": "GeetestSelectObjectTask",
      "imageBase64": "BASE64_BODY_HERE",
      "question": "Select 3 images with",
      "anchor": "BASE64_ICON_HERE"
    }
  }'

const axios = require('axios');

const { data } = await axios.post('https://api.omocaptcha.com/v2/createTask', {
  clientKey: 'OMO_API_KEY',
  task: {
    type: 'GeetestSelectObjectTask',
    imageBase64: 'BASE64_BODY_HERE',
    question: 'Select 3 images with',
    anchor: 'BASE64_ICON_HERE'
  }
});
console.log(data);

import requests

res = requests.post('https://api.omocaptcha.com/v2/createTask', json={
    'clientKey': 'OMO_API_KEY',
    'task': {
        'type': 'GeetestSelectObjectTask',
        'imageBase64': 'BASE64_BODY_HERE',
        'question': 'Select 3 images with',
        'anchor': 'BASE64_ICON_HERE'
    }
})
print(res.json())

<?php
$ch = curl_init('https://api.omocaptcha.com/v2/createTask');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  'clientKey' => 'OMO_API_KEY',
  'task' => [
    'type' => 'GeetestSelectObjectTask',
    'imageBase64' => 'BASE64_BODY_HERE',
    'question' => 'Select 3 images with',
    'anchor' => 'BASE64_ICON_HERE'
  ]
]));
echo curl_exec($ch);

Response Thành công:

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

Máy chủ sẽ trả về errorId = 0 và taskId thành công. Thất bại:

{
  "errorId": 1,
  "errorCode": "",
  "errorDescription": ""
}

Máy chủ sẽ trả về errorId = 1 và errorCode mã lỗi.

2. Nhận kết quả yêu cầu

Request

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

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

Response Thành công:

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

Máy chủ sẽ trả về errorId = 0 và status = ready. Đọc kết quả trong solution.objects.

objects là mảng chỉ số các ô hình trùng khớp (0–8), đếm từ trái sang phải, trên xuống dưới:

Hàng 1: 0, 1, 2
Hàng 2: 3, 4, 5
Hàng 3: 6, 7, 8

Đang xử lý:

{
  "status": "processing",
  "errorId": 0,
  "errorCode": "",
  "errorDescription": ""
}

Máy chủ sẽ trả về errorId = 0 và status = processing, yêu cầu đang được xử lý, xin vui lòng chờ 2 giây rồi yêu cầu lại. Thất bại:

{
  "errorId": 1,
  "errorCode": "ERROR_JOB_STATUS",
  "errorDescription": "Job failed",
  "status": "fail",
  "solution": {}
}

Máy chủ sẽ trả về errorId = 1.

Tài liệu API

Hướng dẫn

GeetestSelectObjectTask

1. Tạo yêu cầu

2. Nhận kết quả yêu cầu

​1. Tạo yêu cầu

​2. Nhận kết quả yêu cầu

1. Tạo yêu cầu

2. Nhận kết quả yêu cầu