ZaloSelectObjectTask

Selecting objects is a popular type of image verification.

1. Create task

Request

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

Parameter	Type	Required	Description
`clientKey`	`String`	✅	Customer account key
`task.type`	`String`	✅	Captcha service class name to solve: `ZaloSelectObjectTask`
`task.imageBase64`	`String`	✅	Base64-encoded 3x3 grid image
`task.other`	`String`	✅	Captcha question text (e.g. `Chọn tất cả ảnh có: biển báo giao thông`)

curl -X POST https://api.omocaptcha.com/v2/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "OMO_API_KEY",
    "task": {
      "type": "ZaloSelectObjectTask",
      "imageBase64": "BASE64_BODY_HERE",
      "other": "Chọn tất cả ảnh có: biển báo giao thông"
    }
  }'

const axios = require('axios');

const response = await axios.post('https://api.omocaptcha.com/v2/createTask', {
  clientKey: 'OMO_API_KEY',
  task: {
    type: 'ZaloSelectObjectTask',
    imageBase64: 'BASE64_BODY_HERE',
    other: 'Chọn tất cả ảnh có: biển báo giao thông'
  }
});

console.log(response.data);

import requests

response = requests.post(
    'https://api.omocaptcha.com/v2/createTask',
    json={
        'clientKey': 'OMO_API_KEY',
        'task': {
            'type': 'ZaloSelectObjectTask',
            'imageBase64': 'BASE64_BODY_HERE',
            'other': 'Chọn tất cả ảnh có: biển báo giao thông'
        }
    }
)

print(response.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' => 'ZaloSelectObjectTask',
        'imageBase64' => 'BASE64_BODY_HERE',
        'other' => 'Chọn tất cả ảnh có: biển báo giao thông'
    ]
]));

$response = curl_exec($ch);
curl_close($ch);
echo $response;

Response Success:

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

The server returns errorId = 0 and a taskId when the task is created successfully. Failure:

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

The server returns errorId = 1 along with an errorCode.

2. Get task result

Request

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

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

Response Success:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "objects": [0, 1, 2, 3]
  }
}

The server returns errorId = 0 and status = ready. Read the result from solution.

Field	Type	Description
`solution.objects`	`Array<Number>`	List of tile indices to select in the 3x3 grid, numbered `0` to `8` from left to right, top to bottom

The 3x3 grid is indexed as follows: top row 0, 1, 2, middle row 3, 4, 5, bottom row 6, 7, 8. Click every tile whose index appears in solution.objects, then press the Xác thực (Verify) button.

Processing:

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

The server returns errorId = 0 and status = processing while the task is being processed. Please wait 2 seconds and retry. Failure:

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

The server returns errorId = 1 when processing fails.

API Reference

Guides

ZaloSelectObjectTask

1. Create task

2. Get task result

​1. Create task

​2. Get task result

1. Create task

2. Get task result