> ## 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.
# GeetestIconWebTask
> Solve Geetest icon-click captcha on web
Icon-click captcha on web is a common Geetest challenge type.
## 1. Create task
### Request
`POST https://api.omocaptcha.com/v2/createTask`
| Parameter | Type | Required | Description |
| ------------------------- | ----------------- | :------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clientKey` | `String` | ✅ | Client account key |
| `task.type` | `String` | ✅ | Captcha service class name: `GeetestIconWebTask` |
| `task.imageBase64` | `String` | ✅ | Background image (clickable area) encoded in base64
|
| `task.anchorImageBase64s` | `Array of String` | ✅ | Array of 3 icon reference images encoded in base64 (3 separate images, in order)
|
```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": "GeetestIconWebTask",
"imageBase64": "BASE64_BODY_HERE",
"anchorImageBase64s": [
"BASE64_ICON_1",
"BASE64_ICON_2",
"BASE64_ICON_3"
]
}
}'
```
```javascript Node.js theme={null}
const res = await fetch("https://api.omocaptcha.com/v2/createTask", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
clientKey: "OMO_API_KEY",
task: {
type: "GeetestIconWebTask",
imageBase64: "BASE64_BODY_HERE",
anchorImageBase64s: [
"BASE64_ICON_1",
"BASE64_ICON_2",
"BASE64_ICON_3"
]
}
})
});
console.log(await res.json());
```
```python Python theme={null}
import requests
res = requests.post("https://api.omocaptcha.com/v2/createTask", json={
"clientKey": "OMO_API_KEY",
"task": {
"type": "GeetestIconWebTask",
"imageBase64": "BASE64_BODY_HERE",
"anchorImageBase64s": [
"BASE64_ICON_1",
"BASE64_ICON_2",
"BASE64_ICON_3"
]
}
})
print(res.json())
```
```php PHP theme={null}
"OMO_API_KEY",
"task" => [
"type" => "GeetestIconWebTask",
"imageBase64" => "BASE64_BODY_HERE",
"anchorImageBase64s" => [
"BASE64_ICON_1",
"BASE64_ICON_2",
"BASE64_ICON_3"
]
]
]));
echo curl_exec($ch);
```
`anchorImageBase64s` must be an array of **3 separate images**, each cropped and ordered left-to-right as shown on the captcha. This order determines the order of points returned in `solution.points`.
### Response
**Success:**
```json theme={null}
{
"errorId": 0,
"taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}
```
Server returns `errorId = 0` and a `taskId` on success.
**Failure:**
```json theme={null}
{
"errorId": 1,
"errorCode": "",
"errorDescription": ""
}
```
Server returns `errorId = 1` with the corresponding `errorCode`.
## 2. Get task result
### Request
`POST https://api.omocaptcha.com/v2/getTaskResult`
```json theme={null}
{
"clientKey": "OMO_API_KEY",
"taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}
```
### Response
**Success:**
```json theme={null}
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
"status": "ready",
"solution": {
"points": [
{ "x": 40, "y": 96 },
{ "x": 32, "y": 29 },
{ "x": 127, "y": 40 }
]
}
}
```
Server returns `errorId = 0` and `status = ready`. Read the answer in the `solution` field.
`solution.points` contains the coordinates (in `imageBase64` pixels) of the **3 icons to click**, ordered to match the `anchorImageBase64s` you sent. Click each point in array order.
**Processing:**
```json theme={null}
{
"status": "processing",
"errorId": 0,
"errorCode": "",
"errorDescription": ""
}
```
Server returns `errorId = 0` and `status = processing`. Wait 2 seconds and retry.
**Failure:**
```json theme={null}
{
"errorId": 1,
"errorCode": "ERROR_JOB_STATUS",
"errorDescription": "Job failed",
"status": "fail",
"solution": {}
}
```
Server returns `errorId = 1` when the task fails.