TiktokSliderWebTask

Slider on the web is a common captcha type. The user needs to drag a puzzle piece to the correct position on the background image.

1. Create task

Request

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

Parameter	Type	Required	Description
`clientKey`	`String`	✅	Client account API key
`task.type`	`String`	✅	Captcha service class name: `TiktokSliderWebTask`
`task.imageBase64`	`String`	✅	Screenshot encoded as base64 (without `data:image/...;base64,` prefix)
`task.widthView`	`Number`	✅	Rendered image width on the web (px). In DevTools, right-click the captcha image → Inspect, then look at Rendered size (e.g. `340 × 212 px`) — the first value is `widthView`.

Sample code

curl -X POST https://api.omocaptcha.com/v2/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "OMO_API_KEY",
    "task": {
      "type": "TiktokSliderWebTask",
      "imageBase64": "BASE64_BODY_HERE",
      "widthView": 340
    }
  }'

const axios = require('axios');

const { data } = await axios.post('https://api.omocaptcha.com/v2/createTask', {
  clientKey: 'OMO_API_KEY',
  task: {
    type: 'TiktokSliderWebTask',
    imageBase64: 'BASE64_BODY_HERE',
    widthView: 340,
  },
});

console.log(data);

import requests

resp = requests.post('https://api.omocaptcha.com/v2/createTask', json={
    'clientKey': 'OMO_API_KEY',
    'task': {
        'type': 'TiktokSliderWebTask',
        'imageBase64': 'BASE64_BODY_HERE',
        'widthView': 340,
    },
})

print(resp.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' => 'TiktokSliderWebTask',
        'imageBase64' => 'BASE64_BODY_HERE',
        'widthView' => 340,
    ],
]));

$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 on success. Failure:

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

The server returns errorId = 1 and the corresponding errorCode. See the Error codes list.

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": {
    "end": {
      "x": 150,
      "y": 42
    }
  }
}

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

Field	Type	Description
`solution.end.x`	Number	Target X coordinate to drag the puzzle piece to (px, relative to `widthView`)
`solution.end.y`	Number	Target Y coordinate to drag the puzzle piece to (px)

end is the target position of the puzzle piece on the image (scaled to widthView). Combine it with the original slider button position to compute the drag distance, then simulate a natural mouse drag (mousedown → mousemove → mouseup).

Processing:

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

The server returns errorId = 0 and status = processing. Please wait 2 seconds and retry. Failure:

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

The server returns errorId = 1. See details in Error codes.

API Reference

Guides

1. Create task

Request

Sample code

Response

2. Get task result

Request

Response

​1. Create task

​Request

​Sample code

​Response

​2. Get task result

​Request

​Response

1. Create task

Request

Sample code

Response

2. Get task result

Request

Response