NEWواجهات API القياسية createTask وin.php. غيّر العنوان وستكون متصلاً.عرض توثيق API
GATESOLVER
ابدأ الآن

توثيق API

الطلبات بصيغة JSON والعنوان واحد (https://gatesolver.com). أرسل مفتاح API الذي أنشأته في صفحة الحساب كقيمة clientKey. أنشئ المهمة (createTask) واستلم النتيجة بعد ثوانٍ (getTaskResult).

العنوان الأساسي
https://gatesolver.com
المصادقة
clientKey في نص الطلب
حد الطلبات
600 طلب في 1 دقيقة لكل مفتاح
الصيغة
JSON (POST)

ابدأ الآن

  1. سجّل واشحن رصيدك.
  2. أنشئ المفتاح من قائمة مفتاح API في صفحة الحساب. يظهر المفتاح مرة واحدة فقط عند إنشائه.
  3. أنشئ مهمة عبر createTask، ثم استدعِ getTaskResult بقيمة taskId المستلمة كل بضع ثوانٍ.
  4. عندما تصبح قيمة status هي ready، ضع solution في الصفحة.

العملاء المبنون لتنسيق createTask يعملون كما هم بمجرد تغيير عنوان API. العنوان الجديد: https://gatesolver.com

createTask

POST https://gatesolver.com/createTask

يُنشئ مهمة ويعيد taskId. لا يُخصم أي مبلغ في هذه الخطوة.

الحقلالصيغةمطلوبالوصف
clientKeystringنعممفتاح API
taskobjectنعمبيانات المهمة: type والحقول الخاصة بكل نوع (انظر جدول type المهام أدناه وصفحة كل نوع)
callbackUrlstringلاغير مدعوم. استلم النتيجة عبر 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 مهمة من الرصيد لحظة ظهور الحل.

الحقلالوصف
statusprocessing (قيد الانتظار)، 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 مهمة
ReCaptchaV2TaskProxyLessreCAPTCHA v2$0.56
ReCaptchaV2TaskreCAPTCHA v2$0.56
ReCaptchaV2EnterpriseTaskProxyLessreCAPTCHA v2 Enterprise$0.70
ReCaptchaV2EnterpriseTaskreCAPTCHA v2 Enterprise$0.70
ReCaptchaV3TaskProxyLessreCAPTCHA v3$0.70
ReCaptchaV3TaskreCAPTCHA v3$0.70
ReCaptchaV3EnterpriseTaskProxyLessreCAPTCHA v3 Enterprise$2.10
ReCaptchaV3EnterpriseTaskreCAPTCHA v3 Enterprise$2.10
AntiTurnstileTaskProxyLessCloudflare Turnstile$0.84
TurnstileTaskProxylessCloudflare Turnstile$0.84
AntiCloudflareTaskCloudflare Challenge$0.84
AntiAwsWafTaskProxyLessAWS WAF$1.40
AntiAwsWafTaskAWS WAF$1.40
GeeTestTaskProxyLessGeeTest v3 / v4$0.84
GeeTestTaskGeeTest v3 / v4$0.84
MtCaptchaTaskProxyLessMTCaptcha$2.10
MtCaptchaTaskMTCaptcha$2.10
DatadomeSliderTaskDataDome Slider$1.75
ImageToTextTaskImage to Text$0.28
ReCaptchaV2ClassificationreCAPTCHA Image Classification$0.28
AwsWafClassificationAWS WAF Image Classification$0.42
VisionEngineVision Engine$1.05

رموز الأخطاء

عند حدوث خطأ تكون قيمة errorId هي 1، ويأتي معها errorCode وerrorDescription. ردود الخطأ لا يُخصم ثمنها.

errorCodeالمعنى
ERROR_KEY_DENIED_ACCESSclientKey مفقود أو غير صحيح.
ERROR_ZERO_BALANCEالرصيد غير كافٍ. اشحن ثم أعد الطلب.
ERROR_TASK_NOT_SUPPORTEDtype المهمة هذا غير مدعوم.
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..."}))