UNLOCK API

Bildraster Lösungs-API

Senden Sie eine Bildraster-Aufgabe an die API und erhalten Sie die Antwort, die Ihr Code an die Seite übermittelt. Das Rasterbild als base64 und die Anweisung, zum Beispiel das auszuwählende Objekt. Sie erhalten: Die Nummern der anzuklickenden Felder.

Auf einen Blick

Preis pro 1.000
$0.36 ($0.00036 pro Aufgabe)
createTask-Typ
GridTask
in.php-Methode
post, recaptcha=1
Sie senden
Das Rasterbild als base64 und die Anweisung, zum Beispiel das auszuwählende Objekt
Sie erhalten
Die Nummern der anzuklickenden Felder

Wo Sie die Werte finden

Senden Sie das gesamte Raster als ein Bild und die Anweisung als comment. rows und columns sind standardmäßig 3.

createTask und getTaskResult

Erstellen Sie die Aufgabe, warten Sie etwa 5 Sekunden und prüfen Sie dann alle 5 Sekunden das Ergebnis, bis der Status ready ist. Schlägt die Aufgabe fehl, liefert die API einen Fehler und der Betrag geht auf Ihr Guthaben zurück.

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 und res.php

Dieselbe Aufgabe mit der klassischen Formular-API. Mit json=1 erhalten Sie JSON-Antworten, ohne diesen Parameter Text wie 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"}

Vollständige API-Referenz: alle Parameter und das solution-Objekt