> ## Documentation Index > Fetch the complete documentation index at: https://docs.omocaptcha.com/llms.txt > Use this file to discover all available pages before exploring further. # ShopeeSliderWebTask > Giải captcha kéo thả (slider) của Shopee trên web. Captcha Shopee là một loại hình ảnh xác thực phổ biến. Người dùng cần kéo mảnh ghép nhỏ vào đúng vị trí trên ảnh nền để hoàn thành xác minh. `ShopeeSliderWebTask` hỗ trợ **hai dạng**: * **Dạng thường** — kéo mảnh ghép theo trục ngang (trả về toạ độ `end`). * **Dạng có quỹ đạo không xác định** (`typeCaptcha = "rotate"`) — kéo mảnh ghép theo quỹ đạo bất kỳ (trả về `point`). ## 1a. Tạo yêu cầu — Dạng kéo thả thường ### Request `POST https://api.omocaptcha.com/v2/createTask` | Tham số | Kiểu | Bắt buộc | Mô tả | | ------------------- | ----------------- | :------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `clientKey` | `String` | ✅ | Khóa API tài khoản khách hàng | | `task.type` | `String` | ✅ | Tên class dịch vụ captcha cần giải | | `task.imageBase64s` | `Array of String` | ✅ | Mảng gồm 2 chuỗi base64
| ### Code mẫu ```bash cURL theme={null} curl -X POST https://api.omocaptcha.com/v2/createTask \ -H "Content-Type: application/json" \ -d '{ "clientKey": "OMO_API_KEY", "task": { "type": "ShopeeSliderWebTask", "imageBase64s": [ "BASE64_MASK_BODY_HERE", "BASE64_BACKGROUND_BODY_HERE" ] } }' ``` ```javascript Node.js theme={null} const axios = require('axios'); const { data } = await axios.post('https://api.omocaptcha.com/v2/createTask', { clientKey: 'OMO_API_KEY', task: { type: 'ShopeeSliderWebTask', imageBase64s: [ 'BASE64_MASK_BODY_HERE', 'BASE64_BACKGROUND_BODY_HERE', ], }, }); console.log(data); ``` ```python Python theme={null} import requests resp = requests.post('https://api.omocaptcha.com/v2/createTask', json={ 'clientKey': 'OMO_API_KEY', 'task': { 'type': 'ShopeeSliderWebTask', 'imageBase64s': [ 'BASE64_MASK_BODY_HERE', 'BASE64_BACKGROUND_BODY_HERE', ], }, }) print(resp.json()) ``` ```php PHP theme={null} 'OMO_API_KEY', 'task' => [ 'type' => 'ShopeeSliderWebTask', 'imageBase64s' => [ 'BASE64_MASK_BODY_HERE', 'BASE64_BACKGROUND_BODY_HERE', ], ], ])); $response = curl_exec($ch); curl_close($ch); echo $response; ``` ### Response **Thành công:** ```json theme={null} { "errorId": 0, "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0" } ``` Máy chủ trả về `errorId = 0` và `taskId` khi tạo yêu cầu thành công. ## 1b. Tạo yêu cầu — Dạng có quỹ đạo không xác định Dùng khi captcha yêu cầu kéo mảnh ghép theo **quỹ đạo bất kỳ** (không cố định theo trục ngang). Truyền thêm `typeCaptcha = "rotate"`. ### Request `POST https://api.omocaptcha.com/v2/createTask` | Tham số | Kiểu | Bắt buộc | Mô tả | | ------------------- | ----------------- | :------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `clientKey` | `String` | ✅ | Khóa API tài khoản khách hàng | | `task.type` | `String` | ✅ | Tên class dịch vụ captcha cần giải | | `task.typeCaptcha` | `String` | ✅ | Tên loại captcha, giá trị | | `task.imageBase64s` | `Array of String` | ✅ | Mảng gồm 2 chuỗi base64

| ### Code mẫu ```bash cURL theme={null} curl -X POST https://api.omocaptcha.com/v2/createTask \ -H "Content-Type: application/json" \ -d '{ "clientKey": "OMO_API_KEY", "task": { "type": "ShopeeSliderWebTask", "typeCaptcha": "rotate", "imageBase64s": [ "BASE64_MASK_BODY_HERE", "BASE64_BACKGROUND_BODY_HERE" ] } }' ``` ```javascript Node.js theme={null} const axios = require('axios'); const { data } = await axios.post('https://api.omocaptcha.com/v2/createTask', { clientKey: 'OMO_API_KEY', task: { type: 'ShopeeSliderWebTask', typeCaptcha: 'rotate', imageBase64s: [ 'BASE64_MASK_BODY_HERE', 'BASE64_BACKGROUND_BODY_HERE', ], }, }); console.log(data); ``` ```python Python theme={null} import requests resp = requests.post('https://api.omocaptcha.com/v2/createTask', json={ 'clientKey': 'OMO_API_KEY', 'task': { 'type': 'ShopeeSliderWebTask', 'typeCaptcha': 'rotate', 'imageBase64s': [ 'BASE64_MASK_BODY_HERE', 'BASE64_BACKGROUND_BODY_HERE', ], }, }) print(resp.json()) ``` ```php PHP theme={null} 'OMO_API_KEY', 'task' => [ 'type' => 'ShopeeSliderWebTask', 'typeCaptcha' => 'rotate', 'imageBase64s' => [ 'BASE64_MASK_BODY_HERE', 'BASE64_BACKGROUND_BODY_HERE', ], ], ])); $response = curl_exec($ch); curl_close($ch); echo $response; ``` ### Response **Thành công:** ```json theme={null} { "errorId": 0, "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0" } ``` **Thất bại:** ```json theme={null} { "errorId": 1, "errorCode": "", "errorDescription": "" } ``` Máy chủ trả về `errorId = 1` và `errorCode` tương ứng. Xem danh sách [Mã lỗi](/vi/api/bang-ma-loi). ## 2a. Nhận kết quả — Dạng thường ### Request `POST https://api.omocaptcha.com/v2/getTaskResult` ```json theme={null} { "clientKey": "OMO_API_KEY", "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0" } ``` ### Response **Thành công:** ```json theme={null} { "errorId": 0, "status": "ready", "solution": { "end": { "x": 150, "y": 42 } } } ``` | Trường | Kiểu | Mô tả | | ---------------- | ------ | -------------------------------------------- | | `solution.end.x` | Number | Tọa độ **X** đích cần kéo mảnh ghép đến (px) | | `solution.end.y` | Number | Tọa độ **Y** đích cần kéo mảnh ghép đến (px) | ## 2b. Nhận kết quả — Dạng có quỹ đạo không xác định ### Request `POST https://api.omocaptcha.com/v2/getTaskResult` ```json theme={null} { "clientKey": "OMO_API_KEY", "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0" } ``` ### Response **Thành công:** ```json theme={null} { "errorId": 0, "status": "ready", "solution": { "point": { "x": 153, "y": 78 } } } ``` | Trường | Kiểu | Mô tả | | ------------------ | ------ | ------------------------------------------------- | | `solution.point.x` | Number | Tọa độ **X** điểm đích cần đưa mảnh ghép tới (px) | | `solution.point.y` | Number | Tọa độ **Y** điểm đích cần đưa mảnh ghép tới (px) | Toạ độ được tính theo hệ pixel của ảnh nền gửi lên. Kết hợp vị trí ban đầu của mảnh ghép và toạ độ trả về để tính quãng đường, sau đó mô phỏng thao tác kéo (mousedown → mousemove → mouseup) với quỹ đạo tự nhiên. **Đang xử lý:** ```json theme={null} { "errorId": 0, "status": "processing", "errorCode": "", "errorDescription": "" } ``` Máy chủ trả về `errorId = 0` và `status = processing`. Vui lòng chờ **2 giây** rồi yêu cầu lại. **Thất bại:** ```json theme={null} { "errorId": 1, "errorCode": "ERROR_JOB_STATUS", "errorDescription": "Job failed", "status": "fail", "solution": {} } ``` Máy chủ trả về `errorId = 1`. Xem chi tiết tại [Mã lỗi](/vi/api/bang-ma-loi).