CAPTCHA çözme API başvuru belgesi

POST /createTask Görev oluşturma

Gövde: clientKey ve bir task nesnesi. Diğer alanları görev türü belirler; Görev türleri bölümüne bakın. Yanıt: errorId 0 ve taskId ya da errorId 1 ile errorCode.

POST https://unlock-api.com/createTask
{"clientKey":"YOUR_API_KEY","task":{"type":"TurnstileTaskProxyless","websiteURL":"https://example.com","websiteKey":"0x4AAAAAAAC3DHQFLr1GavRN"}}

{"errorId":0,"taskId":1001}
{"errorId":1,"errorCode":"ERROR_ZERO_BALANCE","errorDescription":"..."}

POST /getTaskResult Sonucu alma

Gövde: clientKey ve taskId. Görev çalışırken: status processing. Tamamlandığında: solution ve cost ile birlikte status ready. Başarısız bir görev errorId 1 ve errorCode ile yanıt verir.

POST https://unlock-api.com/getTaskResult
{"clientKey":"YOUR_API_KEY","taskId":1001}

{"errorId":0,"status":"processing"}
{"errorId":0,"status":"ready","solution":{"token":"0.zrSnRHO7h0..."},"cost":"0.0012","createTime":1791640000,"endTime":1791640011,"solveCount":1}

POST /getBalance Bakiyeyi alma

Gövde: clientKey. Yanıt: ABD doları cinsinden balance.

{"clientKey":"YOUR_API_KEY"}

{"errorId":0,"balance":42.5}

Yanlış yanıtı bildirme

reportIncorrectRecaptcha ve reportIncorrectImageCaptcha, clientKey ve taskId alır ve success ile yanıt verir. Mevcut kütüphanelerle uyumluluk için kabul edilirler; bildirim ücreti değiştirmez.

Görev gönderme: in.php

Alanlar: key, method ve CAPTCHA türünün alanları. Yanıt: OK|ID veya json=1 ile {"status":1,"request":"ID"}. Hatalar adlarıyla döner, örneğin ERROR_ZERO_BALANCE.

POST https://unlock-api.com/in.php
key=YOUR_API_KEY&method=hcaptcha&sitekey=SITE_KEY&pageurl=https://example.com&json=1

OK|1001
{"status":1,"request":"1001"}

Yanıtı alma: res.php

action=get&id=ID, çözüldüğünde OK|ANSWER, çalışırken CAPCHA_NOT_READY döndürür. action=get2 ücreti de ekler. ids=ID1,ID2 tek seferde en fazla 100 görevi kontrol eder. action=getbalance bakiyeyi döndürür. action=reportbad ve reportgood kabul edilir.

GET https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001
CAPCHA_NOT_READY
OK|P1_eyJ0eXAiOiJKV1Qi...

GET https://unlock-api.com/res.php?key=YOUR_API_KEY&action=getbalance
42.5

POST /getToken Oluştur ve bekle: getToken

createTask ile aynı gövde. Çağrı en fazla 50 saniye bekler ve getTaskResult ile aynı yanıtı döndürür. Görev hâlâ çalışıyorsa yanıt, taskId ile birlikte status processing olur; getTaskResult ile sorgulamaya devam edin.

POST https://unlock-api.com/getToken
{"clientKey":"YOUR_API_KEY","task":{"type":"TurnstileTaskProxyless","websiteURL":"https://example.com","websiteKey":"0x4AAAA..."}}

{"errorId":0,"taskId":1001,"status":"ready","solution":{"token":"0.zrSnRHO7h0..."},"cost":"0.000725"}

Sonuç geri çağrıları

createTask isteğine callbackUrl (veya in.php isteğine pingback) ekleyin; görev bittiğinde sonuç oraya gönderilir: taskId içeren, getTaskResult benzeri bir JSON gövdesi ya da in.php için id=…&code=… form gövdesi. Yalnızca herkese açık adresler, bir kez ve 5 saniyelik zaman aşımıyla çağrılır; sonuç sorgulama yoluyla da erişilebilir kalır.

{"clientKey":"YOUR_API_KEY","callbackUrl":"https://your.server/captcha-result","task":{...}}

POST https://your.server/captcha-result
{"errorId":0,"taskId":1001,"status":"ready","solution":{...},"cost":"0.0005"}

İstatistikler

getQueueStats, bekleyen ve şu anda çözülen görevleri ve son bir saatteki ortalama çözme süresini döndürür. getSpendingStats, bir UTC günü için saatlik hacminizi ve harcamanızı döndürür (date, unix zamanı olarak). test, aldığı gövdeyi aynen geri döndürür.

POST https://unlock-api.com/getQueueStats     {"clientKey":"..."}  ->  {"errorId":0,"waiting":3,"solving":12,"speed":6.4,"total":15}
POST https://unlock-api.com/getSpendingStats  {"clientKey":"...","date":1791590400}  ->  {"errorId":0,"data":[{"dateFrom":...,"volume":120,"money":0.06},...]}
POST https://unlock-api.com/test              {"anything":1}  ->  {"errorId":0,"received":{"anything":1}}

IP izin listesi

Hesap sayfasında bir IP izin listesi ayarlarsanız, diğer IP'lerden gelen istekler ERROR_IP_NOT_ALLOWED alır.