UNLOCK API
Altcha

Altcha

Cómo enviar una tarea de Altcha 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
$1.30 $0.0013 por tarea
Envías
URL de la página y la dirección del challenge o el JSON del challenge
Recibes
Payload para el campo altcha

Resumen y precio

Nombres del tipo de tarea

Usa el primer nombre para resolver sin proxy. Usa el segundo nombre y agrega los campos de proxy para resolver a través de tu propio proxy. El precio es el mismo.
AltchaTaskProxylessSin proxy
AltchaTaskCon tu proxy

Objeto de tarea

type
StringObligatorio
Nombre del tipo de tarea. Se reconoce sin importar mayúsculas o minúsculas. AltchaTaskProxyless | AltchaTask
websiteURL
StringObligatorio
Dirección completa de la página donde aparece el CAPTCHA, que empiece por http:// o https://.
challengeURL
StringOpcional
Dirección desde la que la página carga el challenge de Altcha. Envía esto o challengeJSON.
challengeJSON
StringOpcional
El JSON del challenge de Altcha como texto. Envía esto o challengeURL.

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

Campos de proxy

Solo para el nombre de tipo con proxy. Envía los campos por separado o una sola cadena proxy.
proxyType
StringObligatorio
http, https, socks4 o socks5.
proxyAddress
StringObligatorio
Dirección IP o nombre de host del proxy.
proxyPort
IntegerObligatorio
Puerto del proxy.
proxyLogin
StringOpcional
Usuario del proxy, si el proxy lo requiere.
proxyPassword
StringOpcional
Contraseña del proxy, si el proxy la requiere.
proxy
String
Todos los campos de proxy en una sola cadena, por ejemplo http://user:pass@1.2.3.4:8080.

Uso de proxy

Solicitud

POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "AltchaTaskProxyless",
    "websiteURL": "https://example.com/login",
    "challengeURL": "https://example.com/altcha/challenge"
  }
}

Objeto solution

Se devuelve en solution cuando status es ready.
token
String
El token que hay que enviar con el formulario de la página.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "eyJhbGdvcml0aG0iOiJTSEEtMjU2Ii..."
  },
  "cost": "0.0013",
  "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": "AltchaTaskProxyless",
      "websiteURL": "https://example.com/login",
      "challengeURL": "https://example.com/altcha/challenge"
    }
}).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"]["token"])
        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=altcha&challengeURL=CHALLENGE_URL&pageurl=https://example.com/login&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