UNLOCK API
Altcha

Altcha

Как отправить задачу Altcha в UNLOCK API через createTask или in.php: названия типов задач, все параметры, объект solution, поля прокси и примеры кода на 7 языках.
Цена
$1.30 $0.0013 за задачу
Вы отправляете
URL страницы и адрес challenge или challenge в JSON
Вы получаете
Payload для поля altcha

Обзор и цена

Названия типов задачи

Используйте первое название, чтобы решать без прокси. Используйте второе название и добавьте поля прокси, чтобы решать через свой прокси. Цена одинаковая.
AltchaTaskProxylessБез прокси
AltchaTaskЧерез ваш прокси

Объект задачи

type
StringОбязательный
Название типа задачи. Регистр букв не важен. AltchaTaskProxyless | AltchaTask
websiteURL
StringОбязательный
Полный адрес страницы, на которой показана капча, начиная с http:// или https://.
challengeURL
StringНеобязательный
Адрес, с которого страница загружает challenge Altcha. Отправьте его или challengeJSON.
challengeJSON
StringНеобязательный
JSON challenge Altcha в виде текста. Отправьте его или challengeURL.

Поля, которых здесь нет, передаются решателю как есть.

Поля прокси

Только для названия типа с прокси. Отправьте либо отдельные поля, либо одну строку proxy.
proxyType
StringОбязательный
http, https, socks4 или socks5.
proxyAddress
StringОбязательный
IP-адрес или имя хоста прокси.
proxyPort
IntegerОбязательный
Порт прокси.
proxyLogin
StringНеобязательный
Имя пользователя прокси, если оно нужно.
proxyPassword
StringНеобязательный
Пароль прокси, если он нужен.
proxy
String
Все поля прокси одной строкой, например http://user:pass@1.2.3.4:8080.

Работа через прокси

Запрос

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

Объект solution

Возвращается в solution, когда status равен ready.
token
String
Токен, который нужно отправить с формой страницы.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "eyJhbGdvcml0aG0iOiJTSEEtMjU2Ii..."
  },
  "cost": "0.0013",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

Примеры кода

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")

Метод формы in.php

Та же задача через классический запрос с формой. res.php возвращает ответ текстом.
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 форм: in.php и res.php