UNLOCK API
Coordenadas de clic

Coordenadas de clic

Cómo enviar una tarea de Coordenadas de clic a UNLOCK API con createTask o in.php: nombres del tipo de tarea, todos los parámetros, el objeto solution, los campos de proxy y ejemplos de código en 7 lenguajes.
Precio
$0.60 $0.0006 por tarea
Envías
La imagen en base64 y dónde hacer clic
Recibes
Los puntos x e y donde hacer clic

Resumen y precio

Nombres del tipo de tarea

Este tipo tiene un solo nombre.
CoordinatesTask

También se acepta: ImageToCoordinatesTask

Objeto de tarea

type
StringObligatorio
Nombre del tipo de tarea. Se reconoce sin importar mayúsculas o minúsculas. CoordinatesTask
body
StringObligatorio
La imagen en base64 (JPG, PNG o GIF), de hasta unos 100 KB. Se permite un prefijo data:.
comment
StringOpcional
Instrucción para el resolvedor, por ejemplo la pregunta que aparece sobre la imagen.
minClicks
IntegerOpcional
Mínimo de puntos en los que hacer clic.
maxClicks
IntegerOpcional
Máximo de puntos en los que hacer clic.

Los campos que no aparecen aquí se pasan al resolvedor tal como se envían.

Solicitud

POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "CoordinatesTask",
    "body": "/9j/4AAQSkZJRgABAQ...",
    "comment": "Click the cat"
  }
}

Objeto solution

Se devuelve en solution cuando status es ready.
coordinates
Array
Puntos en los que hacer clic, en píxeles desde la esquina superior izquierda de la imagen.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "coordinates": [
      {
        "x": 114,
        "y": 73
      },
      {
        "x": 201,
        "y": 112
      }
    ]
  },
  "cost": "0.0006",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

Ejemplos de código

import time, requests

API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "CoordinatesTask",
      "body": "/9j/4AAQSkZJRgABAQ...",
      "comment": "Click the cat"
    }
}).json()
if task["errorId"]:
    raise SystemExit(task["errorCode"])

for _ in range(60):   # 60 x 5 s = the 5 minute task limit
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(f"{r['errorCode']}: {r.get('errorDescription', '')}")   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"])
        break
else:
    raise SystemExit("timed out")

Método de formulario in.php

La misma tarea con la solicitud de formulario clásica. res.php devuelve la respuesta como texto.
in.php, res.php
curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=base64&coordinatescaptcha=1&textinstructions=Click+the+cat&body=BASE64_IMAGE&json=1"
# {"status":1,"request":"1001"}

curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001&json=1"
# {"status":0,"request":"CAPCHA_NOT_READY"}  then  {"status":1,"request":"ANSWER"}

API de formulario: in.php y res.php