UNLOCK API

API do rozwiązywania Siatka obrazków

Wyślij zadanie Siatka obrazków do API i odbierz odpowiedź, którą Twój kod przesyła na stronę. Obrazek siatki w base64 i polecenie, np. obiekt do zaznaczenia. Otrzymujesz: Numery komórek do kliknięcia.

W skrócie

Cena za 1000
$0.36 ($0.00036 za zadanie)
Typ createTask
GridTask
Metoda in.php
post, recaptcha=1
Wysyłasz
Obrazek siatki w base64 i polecenie, np. obiekt do zaznaczenia
Otrzymujesz
Numery komórek do kliknięcia

Gdzie znaleźć wartości

Wyślij całą siatkę jako jeden obrazek, a polecenie jako comment. rows i columns domyślnie wynoszą 3.

createTask i getTaskResult

Utwórz zadanie, odczekaj około 5 sekund, a potem sprawdzaj wynik co 5 sekund, aż status będzie ready. Jeśli zadanie się nie powiedzie, API zwróci błąd, a opłata wróci na saldo.

import time, requests

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

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "GridTask",
      "body": "/9j/4AAQSkZJRgABAQ...",
      "comment": "Select all squares with traffic lights",
      "rows": 3,
      "columns": 3
    }
}).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")

in.php i res.php

To samo zadanie przez klasyczne API formularzy. Dodaj json=1, aby otrzymywać odpowiedzi w JSON; bez tego odpowiedzi są zwykłym tekstem, np. OK|1001.

curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=base64&recaptcha=1&textinstructions=Select+all+traffic+lights&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"}

Pełna dokumentacja API: wszystkie parametry i obiekt solution