Gambaran keseluruhan
Kaedah JSON
Tugas token
- reCAPTCHA v2
- reCAPTCHA v2 Enterprise
- reCAPTCHA v3
- Cloudflare Turnstile
- GeeTest v3 / v4
- FunCaptcha (Arkose Labs)
- Amazon AWS WAF
- MTCaptcha
- Friendly Captcha
- Lemin Cropped Captcha
- DataDome
- KeyCaptcha
- Capy Puzzle
- Halaman Cloudflare Challenge
- Cutcaptcha
- CyberSiARA
- atbCAPTCHA
- Tencent Captcha
- Prosopo Procaptcha
- CaptchaFox
- Altcha
- NetEase Yidun
- Yandex SmartCaptcha
- VK Captcha
- Binance Captcha
- Tugas tersuai (Imperva, Temu dan lain-lain)
Dokumentasi UNLOCK API
Hantar CAPTCHA sebagai tugas, kemudian ambil jawapannya. API ini menggunakan nama kaedah, nama tugas dan kod ralat yang sama seperti API penyelesai lain, jadi kebanyakan kod sedia ada berfungsi selepas anda tukar host dan key.
Cara permintaan berfungsi
- 1
createTaskBuat tugas
POST /createTask dengan key anda dan objek task. Anda terima taskId. Harga diambil daripada baki pada masa itu.
- 2
getTaskResultSemak keputusan
Tunggu kira-kira 5 saat, kemudian POST /getTaskResult setiap 5 saat sehingga status menjadi ready.
- 3
solutionGunakan jawapan
Masukkan token atau teks daripada solution ke dalam borang halaman. Jika tugas gagal, caj dikembalikan ke baki.
Asas
- Base URL
https://unlock-api.com- API key
- 32 aksara, di halaman akaun anda. Hantar sebagai clientKey (JSON) atau key (in.php, res.php).
- Format
- Kaedah JSON: POST dengan body JSON. in.php dan res.php: medan borang GET atau POST; tambah json=1 untuk balasan JSON.
- Had
- 1,200 permintaan seminit bagi setiap akaun, termasuk semakan keputusan. Tunggu kira-kira 5 saat selepas membuat tugas, kemudian semak setiap 5 saat.
- Had masa
- Tugas yang tidak selesai dalam 5 minit gagal dengan ERROR_CAPTCHA_UNSOLVABLE dan cajnya dikembalikan ke baki.
- Caj
- Harga tugas diambil semasa tugas dibuat. Tugas gagal dibayar balik secara automatik.
Mula pantas
Selesaikan reCAPTCHA v2 dengan kaedah JSON. Gantikan YOUR_API_KEY dengan key anda.
import time, requests
API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"
task = requests.post(f"{API}/createTask", json={
"clientKey": KEY,
"task": {
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
}
}).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"]["gRecaptchaResponse"])
break
else:
raise SystemExit("timed out")const API = "https://unlock-api.com";
const KEY = "YOUR_API_KEY";
const post = (path, body) => fetch(API + path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) }).then((r) => r.json());
const task = await post("/createTask", {
clientKey: KEY,
task: {
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"
},
});
if (task.errorId) throw new Error(task.errorCode);
let solution = null;
for (let n = 0; n < 60 && !solution; n++) { // 60 x 5 s = the 5 minute task limit
await new Promise((r) => setTimeout(r, 5000));
const r = await post("/getTaskResult", { clientKey: KEY, taskId: task.taskId });
if (r.errorId) throw new Error(r.errorCode + ": " + r.errorDescription); // failed tasks are refunded
if (r.status === "ready") solution = r.solution;
}
if (!solution) throw new Error("timed out");
console.log(solution.gRecaptchaResponse);<?php
$api = "https://unlock-api.com";
$key = "YOUR_API_KEY";
function post($url, $body) {
$c = curl_init($url);
curl_setopt_array($c, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Content-Type: application/json"], CURLOPT_POSTFIELDS => json_encode($body)]);
return json_decode(curl_exec($c), true);
}
$task = post("$api/createTask", ["clientKey" => $key, "task" => json_decode('{"type":"RecaptchaV2TaskProxyless","websiteURL":"https://example.com/login","websiteKey":"6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"}', true)]);
if ($task["errorId"]) exit($task["errorCode"]);
for ($n = 0; $n < 60; $n++) { // 60 x 5 s = the 5 minute task limit
sleep(5);
$r = post("$api/getTaskResult", ["clientKey" => $key, "taskId" => $task["taskId"]]);
if ($r["errorId"]) exit($r["errorCode"] . ": " . $r["errorDescription"]); // failed tasks are refunded
if ($r["status"] === "ready") break;
}
if ($r["status"] !== "ready") exit("timed out");
print_r($r["solution"]["gRecaptchaResponse"]);package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"time"
)
const api = "https://unlock-api.com"
const key = "YOUR_API_KEY"
func post(method string, body map[string]any) map[string]any {
b, _ := json.Marshal(body)
res, err := http.Post(api+"/"+method, "application/json", bytes.NewReader(b))
if err != nil {
panic(err)
}
defer res.Body.Close()
var out map[string]any
json.NewDecoder(res.Body).Decode(&out)
return out
}
func main() {
task := post("createTask", map[string]any{
"clientKey": key,
"task": map[string]any{
"type": "RecaptchaV2TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo",
},
})
if task["errorId"].(float64) != 0 {
panic(task["errorCode"])
}
for n := 0; n < 60; n++ { // 60 x 5 s = the 5 minute task limit
time.Sleep(5 * time.Second)
r := post("getTaskResult", map[string]any{"clientKey": key, "taskId": task["taskId"]})
if r["errorId"].(float64) != 0 {
panic(r["errorCode"]) // failed tasks are refunded
}
if r["status"] == "ready" {
fmt.Println(r["solution"])
return
}
}
panic("timed out")
}import java.net.URI;
import java.net.http.*;
import java.util.regex.*;
public class Solve {
static final String API = "https://unlock-api.com", KEY = "YOUR_API_KEY";
static final HttpClient HTTP = HttpClient.newHttpClient();
static String post(String method, String json) throws Exception {
var req = HttpRequest.newBuilder(URI.create(API + "/" + method))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(json)).build();
return HTTP.send(req, HttpResponse.BodyHandlers.ofString()).body();
}
public static void main(String[] args) throws Exception {
String task = "{\"type\":\"RecaptchaV2TaskProxyless\",\"websiteURL\":\"https://example.com/login\",\"websiteKey\":\"6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo\"}";
String created = post("createTask", "{\"clientKey\":\"" + KEY + "\",\"task\":" + task + "}");
Matcher id = Pattern.compile("\"taskId\":(\\d+)").matcher(created);
if (!id.find()) throw new RuntimeException(created);
for (int n = 0; n < 60; n++) { // 60 x 5 s = the 5 minute task limit
Thread.sleep(5000);
String r = post("getTaskResult", "{\"clientKey\":\"" + KEY + "\",\"taskId\":" + id.group(1) + "}");
if (r.contains("\"errorId\":1")) throw new RuntimeException(r); // failed tasks are refunded
if (r.contains("\"status\":\"ready\"")) { System.out.println(r); return; }
}
throw new RuntimeException("timed out");
}
}using System.Net.Http.Json;
using System.Text.Json;
const string Api = "https://unlock-api.com";
const string Key = "YOUR_API_KEY";
var http = new HttpClient();
async Task<JsonElement> Post(string method, object body) =>
await (await http.PostAsJsonAsync($"{Api}/{method}", body)).Content.ReadFromJsonAsync<JsonElement>();
var task = await Post("createTask", new {
clientKey = Key,
task = JsonSerializer.Deserialize<JsonElement>("""
{"type":"RecaptchaV2TaskProxyless","websiteURL":"https://example.com/login","websiteKey":"6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"}
""")
});
if (task.GetProperty("errorId").GetInt32() != 0) throw new Exception(task.GetProperty("errorCode").GetString());
for (var n = 0; n < 60; n++) { // 60 x 5 s = the 5 minute task limit
await Task.Delay(5000);
var r = await Post("getTaskResult", new { clientKey = Key, taskId = task.GetProperty("taskId").GetInt64() });
if (r.GetProperty("errorId").GetInt32() != 0) throw new Exception(r.GetProperty("errorCode").GetString()); // failed tasks are refunded
if (r.GetProperty("status").GetString() == "ready") { Console.WriteLine(r.GetProperty("solution")); return; }
}
throw new Exception("timed out");curl -s https://unlock-api.com/createTask \
-H "Content-Type: application/json" \
-d '{"clientKey":"YOUR_API_KEY","task":{"type":"RecaptchaV2TaskProxyless","websiteURL":"https://example.com/login","websiteKey":"6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo"}}'
# {"errorId":0,"taskId":1001}
curl -s https://unlock-api.com/getTaskResult \
-H "Content-Type: application/json" \
-d '{"clientKey":"YOUR_API_KEY","taskId":1001}'
# {"errorId":0,"status":"processing"} then {"errorId":0,"status":"ready","solution":{...},"cost":"0.001"}Kaedah
createTaskMembuat tugas dan memulangkan id tugas. Harga jenis tugas diambil daripada baki apabila tugas diterima, dan dikembalikan jika tugas gagal.getTaskResultMemulangkan keadaan tugas. Semasa tugas diselesaikan, status ialah processing. Apabila selesai, status ialah ready dan solution mengandungi jawapan. Tugas gagal memulangkan errorId 1 dengan sebabnya, dan cajnya sudah dikembalikan ke baki.getBalanceMemulangkan baki akaun dalam dolar AS.getTokenMembuat tugas dan menunggu jawapan dalam permintaan yang sama, sehingga 50 saat. Jika tugas belum selesai pada masa itu, balasan ialah status processing dengan taskId; teruskan menyemaknya dengan getTaskResult. Callback keputusan tidak dihantar untuk tugas getToken.getQueueStatsMemulangkan barisan semasa: tugas yang menunggu, tugas yang sedang diselesaikan dan purata masa penyelesaian dalam sejam terakhir. Angka ini datang daripada tugas sebenar, bukan anggaran.getSpendingStatsMemulangkan perbelanjaan anda untuk satu hari UTC, jam demi jam: bilangan tugas dan wang yang dibelanjakan. Tugas gagal dan tugas yang dibayar balik tidak dikira.reportCorrect, reportIncorrectLaporkan jawapan yang betul atau salah. Panggilan ini diterima supaya pustaka sedia ada terus berfungsi; laporan tidak mengubah caj.testEcho untuk nyahpepijat. Memulangkan body JSON yang diterima, tanpa clientKey. Tiada semakan key, tiada caj.
Panduan
- API key dan keselamatanCara menghantar key, menggunakan lebih daripada satu key dan membenarkan pelayan anda sahaja.
- Had, masa dan cajHad permintaan, kekerapan menyemak keputusan, had masa dan bila anda dicaj.
- Kod ralatSetiap kod ralat, maksudnya, tindakan yang perlu diambil dan sama ada anda dicaj.
- Menggunakan proxyBila perlu menyelesaikan melalui proxy anda sendiri dan cara menghantarnya.
- Callback keputusanTerima keputusan yang dihantar ke pelayan anda tanpa perlu menyemaknya.
- API borang: in.php dan res.phpPermintaan in.php dan res.php klasik, untuk kod yang ditulis bagi API penyelesai lama.
Jenis tugas
Setiap jenis ada halaman sendiri dengan setiap parameter, objek solution dan contoh.
Tugas token
- reCAPTCHA v2
RecaptchaV2TaskProxylessuserrecaptcha - reCAPTCHA v2 Enterprise
RecaptchaV2EnterpriseTaskProxylessuserrecaptcha, enterprise=1 - reCAPTCHA v3
RecaptchaV3TaskProxylessuserrecaptcha, version=v3 - Cloudflare Turnstile
TurnstileTaskProxylessturnstile - GeeTest v3 / v4
GeeTestTaskProxylessgeetest, geetest_v4 - FunCaptcha (Arkose Labs)
FunCaptchaTaskProxylessfuncaptcha - Amazon AWS WAF
AmazonTaskProxylessamazon_waf - MTCaptcha
MtCaptchaTaskProxylessmt_captcha - Friendly Captcha
FriendlyCaptchaTaskProxylessfriendly_captcha - Lemin Cropped Captcha
LeminTaskProxylesslemin - DataDome
DataDomeSliderTaskdatadome - KeyCaptcha
KeyCaptchaTaskProxylesskeycaptcha - Capy Puzzle
CapyTaskProxylesscapy - Halaman Cloudflare Challenge
AntiCloudflareTaskcloudflare_challenge - Cutcaptcha
CutCaptchaTaskProxylesscutcaptcha - CyberSiARA
AntiCyberSiAraTaskProxylesscybersiara - atbCAPTCHA
AtbCaptchaTaskProxylessatb_captcha - Tencent Captcha
TencentTaskProxylesstencent - Prosopo Procaptcha
ProsopoTaskProxylessprosopo - CaptchaFox
CaptchaFoxTaskProxylesscaptchafox - Altcha
AltchaTaskProxylessaltcha - NetEase Yidun
YidunTaskProxylessyidun - Yandex SmartCaptcha
YandexSmartCaptchaTaskProxylessyandex - VK Captcha
VKCaptchaTaskProxylessvkcaptcha - Binance Captcha
BinanceTaskProxylessbinance - Tugas tersuai (Imperva, Temu dan lain-lain)
CustomTaskincapsula, temuimage, hunt, tspd, basilisk
Tugas imej dan audio
- Imej ke teks
ImageToTextTaskpost, base64 - Soalan teks
TextCaptchaTasktextcaptcha - Grid imej
GridTaskpost, recaptcha=1 - Koordinat klik
CoordinatesTaskpost, coordinatescaptcha=1 - Putar
RotateTaskrotatecaptcha - Audio
AudioTaskaudio - Bounding box
BoundingBoxTaskbounding_box - Lukis sekeliling
DrawAroundTaskpost, canvas=1 - Seret dan lepas
DragAndDropTask- - Tugas imej kompleks
ComplexImageTask-