توثيق API
الطلبات بصيغة JSON والعنوان واحد (https://gatesolver.com). أرسل مفتاح API الذي أنشأته في صفحة الحساب كقيمة clientKey. أنشئ المهمة (createTask) واستلم النتيجة بعد ثوانٍ (getTaskResult).
- العنوان الأساسي
- https://gatesolver.com
- المصادقة
- clientKey في نص الطلب
- حد الطلبات
- 600 طلب في 1 دقيقة لكل مفتاح
- الصيغة
- JSON (POST)
ابدأ الآن
- سجّل واشحن رصيدك.
- أنشئ المفتاح من قائمة مفتاح API في صفحة الحساب. يظهر المفتاح مرة واحدة فقط عند إنشائه.
- أنشئ مهمة عبر createTask، ثم استدعِ getTaskResult بقيمة taskId المستلمة كل بضع ثوانٍ.
- عندما تصبح قيمة status هي ready، ضع solution في الصفحة.
العملاء المبنون لتنسيق createTask يعملون كما هم بمجرد تغيير عنوان API. العنوان الجديد: https://gatesolver.com
createTask
POST https://gatesolver.com/createTask
يُنشئ مهمة ويعيد taskId. لا يُخصم أي مبلغ في هذه الخطوة.
| الحقل | الصيغة | مطلوب | الوصف |
|---|---|---|---|
| clientKey | string | نعم | مفتاح API |
| task | object | نعم | بيانات المهمة: type والحقول الخاصة بكل نوع (انظر جدول type المهام أدناه وصفحة كل نوع) |
| callbackUrl | string | لا | غير مدعوم. استلم النتيجة عبر getTaskResult. |
الطلب
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
}
}الرد
{ "errorId": 0, "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" }getTaskResult
POST https://gatesolver.com/getTaskResult
يعيد نتيجة المهمة. يُفضَّل الاستعلام كل 3 ثوانٍ للأنواع القائمة على الرموز وكل 1 ثانية للتعرف على الصور. يُخصم ثمن 1 مهمة من الرصيد لحظة ظهور الحل.
| الحقل | الوصف |
|---|---|
| status | processing (قيد الانتظار)، ready (الحل جاهز)، failed (فشل، دون خصم) |
| solution | الحل. تختلف الحقول حسب النوع (gRecaptchaResponse، token، cookie، text، إلخ) |
| cost | المبلغ المخصوم لهذه المهمة (بالدولار) |
| createTime / endTime | وقت الإنشاء ووقت الانتهاء (بالمللي ثانية) |
{
"errorId": 0,
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006",
"status": "ready",
"solution": { "gRecaptchaResponse": "03AFcWeA6...", "userAgent": "Mozilla/5.0 ..." },
"cost": "0.000560"
}getBalance
POST https://gatesolver.com/getBalance
يعيد الرصيد بالدولار.
{ "clientKey": "YOUR_API_KEY" }
{ "errorId": 0, "balance": 42.5 }type المهمة
أسماء type لا تتأثر بحالة الأحرف. الحقول والأمثلة لكل نوع موجودة في صفحة النوع.
| type | النوع | 1,000 مهمة |
|---|---|---|
| ReCaptchaV2TaskProxyLess | reCAPTCHA v2 | $0.56 |
| ReCaptchaV2Task | reCAPTCHA v2 | $0.56 |
| ReCaptchaV2EnterpriseTaskProxyLess | reCAPTCHA v2 Enterprise | $0.70 |
| ReCaptchaV2EnterpriseTask | reCAPTCHA v2 Enterprise | $0.70 |
| ReCaptchaV3TaskProxyLess | reCAPTCHA v3 | $0.70 |
| ReCaptchaV3Task | reCAPTCHA v3 | $0.70 |
| ReCaptchaV3EnterpriseTaskProxyLess | reCAPTCHA v3 Enterprise | $2.10 |
| ReCaptchaV3EnterpriseTask | reCAPTCHA v3 Enterprise | $2.10 |
| AntiTurnstileTaskProxyLess | Cloudflare Turnstile | $0.84 |
| TurnstileTaskProxyless | Cloudflare Turnstile | $0.84 |
| AntiCloudflareTask | Cloudflare Challenge | $0.84 |
| AntiAwsWafTaskProxyLess | AWS WAF | $1.40 |
| AntiAwsWafTask | AWS WAF | $1.40 |
| GeeTestTaskProxyLess | GeeTest v3 / v4 | $0.84 |
| GeeTestTask | GeeTest v3 / v4 | $0.84 |
| MtCaptchaTaskProxyLess | MTCaptcha | $2.10 |
| MtCaptchaTask | MTCaptcha | $2.10 |
| DatadomeSliderTask | DataDome Slider | $1.75 |
| ImageToTextTask | Image to Text | $0.28 |
| ReCaptchaV2Classification | reCAPTCHA Image Classification | $0.28 |
| AwsWafClassification | AWS WAF Image Classification | $0.42 |
| VisionEngine | Vision Engine | $1.05 |
رموز الأخطاء
عند حدوث خطأ تكون قيمة errorId هي 1، ويأتي معها errorCode وerrorDescription. ردود الخطأ لا يُخصم ثمنها.
| errorCode | المعنى |
|---|---|
| ERROR_KEY_DENIED_ACCESS | clientKey مفقود أو غير صحيح. |
| ERROR_ZERO_BALANCE | الرصيد غير كافٍ. اشحن ثم أعد الطلب. |
| ERROR_TASK_NOT_SUPPORTED | type المهمة هذا غير مدعوم. |
| ERROR_INVALID_TASK_DATA | حقل مطلوب مفقود. اسم الحقل المفقود موجود في errorDescription. |
| ERROR_TASKID_INVALID | قيمة taskId غير موجودة أو لم تُنشأ بهذا المفتاح. |
| ERROR_CAPTCHA_UNSOLVABLE | تعذّر الحل. لم يُخصم أي مبلغ. أعد الطلب. |
| ERROR_SERVICE_UNAVAILABLE | خطأ في الشبكة. لم يُخصم أي مبلغ. أعد الطلب بعد قليل. |
| ERROR_RATE_LIMIT | تجاوزت 600 طلب في 1 دقيقة. زِد الفاصل بين الطلبات. |
| ERROR_ACCOUNT_SUSPENDED | هذا الحساب موقوف. |
متوافق مع in.php
بالنسبة للبرامج المبنية على نمط in.php، غيّر العنوان فقط. طرق method المدعومة: userrecaptcha (reCAPTCHA v2)، وturnstile، وgeetest، وbase64 وpost (نص الصورة).
GET https://gatesolver.com/in.php?key=YOUR_API_KEY&method=userrecaptcha&googlekey=6Le...&pageurl=https://example.com
OK|61138bb6-19fb-11ec-a9c8-0242ac110006
GET https://gatesolver.com/res.php?key=YOUR_API_KEY&action=get&id=61138bb6-19fb-11ec-a9c8-0242ac110006
CAPCHA_NOT_READY
OK|03AFcWeA6...
GET https://gatesolver.com/res.php?key=YOUR_API_KEY&action=getbalance
42.50000عند إضافة json=1 يأتي الرد بالشكل {"status":1,"request":"..."}.
أمثلة
import requests, time
API, KEY = "https://gatesolver.com", "YOUR_API_KEY"
def solve(task, wait=3, timeout=120):
r = requests.post(f"{API}/createTask", json={"clientKey": KEY, "task": task}, timeout=30).json()
if r.get("errorId"):
raise RuntimeError(r["errorCode"])
end = time.time() + timeout
while time.time() < end:
time.sleep(wait)
res = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": r["taskId"]}, timeout=30).json()
if res.get("errorId"):
raise RuntimeError(res["errorCode"])
if res["status"] == "ready":
return res["solution"]
raise TimeoutError("task timed out")
print(solve({"type": "ReCaptchaV2TaskProxyLess", "websiteURL": "https://example.com", "websiteKey": "6Le..."}))const API = "https://gatesolver.com", KEY = "YOUR_API_KEY";
const post = (p, b) => fetch(API + p, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(b) }).then((r) => r.json());
export async function solve(task, wait = 3000) {
const r = await post("/createTask", { clientKey: KEY, task });
if (r.errorId) throw new Error(r.errorCode);
for (;;) {
await new Promise((s) => setTimeout(s, wait));
const res = await post("/getTaskResult", { clientKey: KEY, taskId: r.taskId });
if (res.errorId) throw new Error(res.errorCode);
if (res.status === "ready") return res.solution;
}
}body, _ := json.Marshal(map[string]any{"clientKey": "YOUR_API_KEY", "task": map[string]any{
"type": "AntiTurnstileTaskProxyLess", "websiteURL": "https://example.com", "websiteKey": "0x4AAAAAAA..."}})
res, err := http.Post("https://gatesolver.com/createTask", "application/json", bytes.NewReader(body))$ch = curl_init("https://gatesolver.com/createTask");
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["clientKey" => "YOUR_API_KEY", "task" => [
"type" => "ReCaptchaV3TaskProxyLess", "websiteURL" => "https://example.com", "websiteKey" => "6Lc...", "pageAction" => "login"]])]);
$task = json_decode(curl_exec($ch), true);curl -X POST https://gatesolver.com/createTask -H "Content-Type: application/json" \
-d '{"clientKey":"YOUR_API_KEY","task":{"type":"ImageToTextTask","body":"iVBORw0KGgo..."}}'