UNLOCK API
GeeTest v3 / v4

GeeTest v3 / v4

Comment envoyer une tâche GeeTest v3 / v4 à UNLOCK API avec createTask ou in.php : noms du type de tâche, tous les paramètres, l'objet solution, les champs proxy et des exemples de code dans 7 langages.
Prix
$0.70 $0.0007 par tâche
Vous envoyez
URL de la page avec gt et challenge (v3) ou captcha_id (v4)
Vous recevez
Les valeurs envoyées par le formulaire GeeTest

Présentation et prix

Noms du type de tâche

Utilisez le premier nom pour résoudre sans proxy. Utilisez le second nom et ajoutez les champs proxy pour résoudre via votre propre proxy. Le prix est le même.
GeeTestTaskProxylessSans proxy
GeeTestTaskVia votre proxy

Objet tâche

type
StringObligatoire
Nom du type de tâche. Reconnu quelle que soit la casse. GeeTestTaskProxyless | GeeTestTask
websiteURL
StringObligatoire
Adresse complète de la page où apparaît le CAPTCHA, commençant par http:// ou https://.
gt
StringFacultatif
GeeTest v3 : la valeur gt de la page.
challenge
StringFacultatif
GeeTest v3 : une valeur challenge récente. Obtenez-en une nouvelle pour chaque tâche.
geetestApiServerSubdomain
StringFacultatif
Serveur API GeeTest, si la page utilise le sien.
version
IntegerFacultatif
4 pour GeeTest v4. Par défaut 3.
initParameters
ObjectFacultatif
GeeTest v4 : un objet avec captcha_id.
userAgent
StringFacultatif
User-Agent du navigateur à utiliser pendant la résolution. Envoyez le même quand vous soumettez la réponse.

Les champs qui ne figurent pas ici sont transmis au résolveur tels qu'envoyés.

Champs proxy

Uniquement pour le nom de type avec proxy. Envoyez soit les champs séparés, soit une seule chaîne proxy.
proxyType
StringObligatoire
http, https, socks4 ou socks5.
proxyAddress
StringObligatoire
Adresse IP ou nom d'hôte du proxy.
proxyPort
IntegerObligatoire
Port du proxy.
proxyLogin
StringFacultatif
Nom d'utilisateur du proxy, si le proxy en demande un.
proxyPassword
StringFacultatif
Mot de passe du proxy, si le proxy en demande un.
proxy
String
Tous les champs proxy dans une seule chaîne, par exemple http://user:pass@1.2.3.4:8080.

Utiliser un proxy

Requête

POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "GeeTestTaskProxyless",
    "websiteURL": "https://example.com/login",
    "gt": "81388ea1fc187e0c335c0a8907ff2625",
    "challenge": "2e2f0f65240058b683cb6ea21c303eea"
  }
}

Objet solution

Renvoyé dans solution quand status vaut ready.
challenge
String
challenge GeeTest v3 à soumettre.
validate
String
Valeur validate GeeTest v3.
seccode
String
Valeur seccode GeeTest v3.
captcha_id
String
captcha_id GeeTest v4.
lot_number
String
lot_number GeeTest v4.
pass_token
String
pass_token GeeTest v4.
gen_time
String
gen_time GeeTest v4.
captcha_output
String
captcha_output GeeTest v4.
POST /getTaskResult
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "challenge": "1ad03db8aff920037fb8117827eab171gu",
    "validate": "0e0ab9f2fdbf7b8e2c3c1a2d4f2c9b07",
    "seccode": "0e0ab9f2fdbf7b8e2c3c1a2d4f2c9b07|jordan",
    "captcha_id": "(v4) e392e1d7fd421dc63325744d5a2b9c73",
    "lot_number": "(v4) e6c3bed2854f41f880662c48afff5dcb",
    "pass_token": "(v4) fad5eb52fc83bf7617f4...",
    "gen_time": "(v4) 1693924478",
    "captcha_output": "(v4) fN36ufW6cQN2SQ-I..."
  },
  "cost": "0.0007",
  "createTime": 1791640000,
  "endTime": 1791640014,
  "solveCount": 1
}

Exemples de code

import time, requests

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

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "GeeTestTaskProxyless",
      "websiteURL": "https://example.com/login",
      "gt": "81388ea1fc187e0c335c0a8907ff2625",
      "challenge": "2e2f0f65240058b683cb6ea21c303eea"
    }
}).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éthode formulaire in.php

La même tâche avec la requête de formulaire classique. res.php renvoie la réponse en texte.
in.php, res.php
curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=geetest&gt=GT&challenge=CHALLENGE&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 formulaire : in.php et res.php