UNLOCK API
GeeTest v3 / v4

GeeTest v3 / v4

Como enviar uma tarefa de GeeTest v3 / v4 para a UNLOCK API com createTask ou in.php: nomes do tipo de tarefa, todos os parâmetros, o objeto solution, os campos de proxy e exemplos de código em 7 linguagens.
Preço
$0.70 $0.0007 por tarefa
Você envia
URL da página com gt e challenge (v3) ou captcha_id (v4)
Você recebe
Os valores que o formulário do GeeTest envia

Visão geral e preço

Nomes do tipo de tarefa

Use o primeiro nome para resolver sem proxy. Use o segundo nome e adicione os campos de proxy para resolver pelo seu próprio proxy. O preço é o mesmo.
GeeTestTaskProxylessSem proxy
GeeTestTaskCom seu proxy

Objeto da tarefa

type
StringObrigatório
Nome do tipo de tarefa. Reconhecido com letras maiúsculas ou minúsculas. GeeTestTaskProxyless | GeeTestTask
websiteURL
StringObrigatório
Endereço completo da página onde o CAPTCHA aparece, começando com http:// ou https://.
gt
StringOpcional
GeeTest v3: o valor gt da página.
challenge
StringOpcional
GeeTest v3: um valor challenge novo. Pegue um novo para cada tarefa.
geetestApiServerSubdomain
StringOpcional
Servidor de API do GeeTest, se a página usar um próprio.
version
IntegerOpcional
4 para GeeTest v4. Padrão 3.
initParameters
ObjectOpcional
GeeTest v4: um objeto com captcha_id.
userAgent
StringOpcional
User-Agent do navegador a usar na resolução. Envie o mesmo quando enviar a resposta.

Campos que não aparecem aqui são repassados ao resolvedor como foram enviados.

Campos de proxy

Só para o nome de tipo com proxy. Envie os campos separados ou uma única string proxy.
proxyType
StringObrigatório
http, https, socks4 ou socks5.
proxyAddress
StringObrigatório
Endereço IP ou nome de host do proxy.
proxyPort
IntegerObrigatório
Porta do proxy.
proxyLogin
StringOpcional
Usuário do proxy, se o proxy exigir.
proxyPassword
StringOpcional
Senha do proxy, se o proxy exigir.
proxy
String
Todos os campos de proxy em uma única string, por exemplo http://user:pass@1.2.3.4:8080.

Usando proxy

Requisição

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

Objeto solution

Retornado em solution quando status é ready.
challenge
String
challenge do GeeTest v3 a enviar.
validate
String
Valor validate do GeeTest v3.
seccode
String
Valor seccode do GeeTest v3.
captcha_id
String
captcha_id do GeeTest v4.
lot_number
String
lot_number do GeeTest v4.
pass_token
String
pass_token do GeeTest v4.
gen_time
String
gen_time do GeeTest v4.
captcha_output
String
captcha_output do 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
}

Exemplos 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": "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étodo de formulário in.php

A mesma tarefa com a requisição de formulário clássica. res.php retorna a resposta como texto.
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 de formulário: in.php e res.php