UNLOCK API
GeeTest v3 / v4

GeeTest v3 / v4

createTask나 in.php로 UNLOCK API에 GeeTest v3 / v4 작업을 보내는 방법이에요. 작업 종류 이름, 모든 항목, solution 객체, 프록시 항목, 7개 언어 코드 예시를 담았어요.
가격
$0.70 1건당 $0.0007
보내는 것
페이지 주소와 gt, challenge(v3) 또는 captcha_id(v4)
받는 것
GeeTest 양식이 보내는 값

소개와 가격

작업 종류 이름

프록시 없이 풀려면 첫 번째 이름을 쓰세요. 내 프록시로 풀려면 두 번째 이름을 쓰고 프록시 항목을 더하세요. 가격은 같아요.
GeeTestTaskProxyless프록시 없이
GeeTestTask내 프록시 사용

task 객체

type
String필수
작업 종류 이름이에요. 대소문자는 가리지 않아요. GeeTestTaskProxyless | GeeTestTask
websiteURL
String필수
캡차가 나오는 페이지의 전체 주소예요. http:// 또는 https://로 시작해요.
gt
String선택
GeeTest v3: 페이지에 있는 gt 값이에요.
challenge
String선택
GeeTest v3: 새 challenge 값이에요. 작업마다 새로 받으세요.
geetestApiServerSubdomain
String선택
페이지가 따로 쓰는 GeeTest API 서버가 있으면 넣어요.
version
Integer선택
GeeTest v4면 4예요. 기본값은 3이에요.
initParameters
Object선택
GeeTest v4: captcha_id가 든 객체예요.
userAgent
String선택
풀 때 쓸 브라우저 User-Agent예요. 답을 낼 때도 같은 값을 보내세요.

여기 없는 항목은 보낸 그대로 풀이 쪽에 넘겨요.

프록시 항목

프록시용 종류 이름일 때만 써요. 항목을 따로 보내거나 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": "GeeTestTaskProxyless",
    "websiteURL": "https://example.com/login",
    "gt": "81388ea1fc187e0c335c0a8907ff2625",
    "challenge": "2e2f0f65240058b683cb6ea21c303eea"
  }
}

solution 객체

status가 ready일 때 solution에 담겨 와요.
challenge
String
낼 GeeTest v3 challenge예요.
validate
String
GeeTest v3 validate 값이에요.
seccode
String
GeeTest v3 seccode 값이에요.
captcha_id
String
GeeTest v4 captcha_id예요.
lot_number
String
GeeTest v4 lot_number예요.
pass_token
String
GeeTest v4 pass_token이에요.
gen_time
String
GeeTest v4 gen_time이에요.
captcha_output
String
GeeTest v4 captcha_output이에요.
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
}

코드 예시

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

in.php 폼 방식

같은 작업을 예전 폼 요청으로 보내는 방법이에요. res.php가 답을 글자로 돌려줘요.
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: in.php와 res.php