تجاوز CAPTCHA باستخدام Go

حل CAPTCHA باستخدام SDK للغة Go عبر الإنترنت.

حزمة Golang لتكامل سهل مع API لخدمة حل CAPTCHA في 2Captcha لتجاوز reCAPTCHA وArkose captcha وGeetest وحل أي CAPTCHA أخرى

بدء سريع

التثبيت

يمكن تثبيت حزمة السكربت عبر مدير الحزم أو يدويًا

GitHub

لتثبيت عميل API استخدم التالي:

go get -u github.com/2captcha/2captcha-go

ندعوك لاستكشاف مستودعنا على GitHub حيث ستجد مكتبات وSDK لتكامل سهل مع API الخاص بنا.

الإعداد

وصف لجميع المعلمات اللازمة لتهيئة الحزمة المثبتة

يمكن إنشاء مثيل Client هكذا:

client := api2captcha.NewClient('YOUR_API_KEY')

يمكنك أيضًا تخصيص بعض الخيارات للمثيل الذي تم إنشاؤه:

client.SoftId = 123
client.Callback = "https://your.site/result-receiver"
client.DefaultTimeout = 120
client.RecaptchaTimeout = 600
client.PollingInterval = 100

خيارات مثيل Client

الخيار	القيمة الافتراضية	الوصف
softId	-	معرّف برنامجك الذي تحصل عليه بعد النشر في كتالوج برامج 2Captcha
callback	-	رابط خادم الويب الذي يستقبل نتيجة التعرّف على CAPTCHA. يجب تسجيل الرابط أولًا في إعدادات pingback في حسابك
defaultTimeout	120	مهلة الاستطلاع بالثواني لجميع أنواع CAPTCHA باستثناء reCAPTCHA. تحدد مدة محاولة SDK للحصول على الإجابة من نقطة نهاية API `res.php`
recaptchaTimeout	600	مهلة الاستطلاع لـ reCAPTCHA بالثواني. تحدد مدة محاولة SDK للحصول على الإجابة من نقطة نهاية API `res.php`
pollingInterval	10	الفاصل بالثواني بين الطلبات إلى نقطة نهاية API `res.php`، ولا يُنصح بقيم أقل من 5 ثوانٍ

مهم: عند تعيين callback لمثيل Client ستُرجع جميع الطرق فقط معرّف CAPTCHA ولن تقوم باستطلاع API للحصول على النتيجة. سيتم إرسال النتيجة إلى رابط callback. للحصول على الإجابة يدويًا استخدم طريقة getResult

حل CAPTCHA

عند إرسال أي CAPTCHA تعتمد على صورة، يمكنك توفير خيارات إضافية لمساعدة عاملي 2Captcha على حلّها بشكل صحيح

خيارات CAPTCHA

الخيار	القيمة الافتراضية	الوصف
numeric	0	يحدد ما إذا كانت CAPTCHA تحتوي أرقامًا أو رموزًا أخرى اطّلع على التفاصيل في مستندات API
minLength	0	الحد الأدنى لطول الإجابة
maxLength	0	الحد الأقصى لطول الإجابة
phrase	0	يحدد ما إذا كانت الإجابة متعددة الكلمات أم لا
caseSensitive	0	يحدد ما إذا كانت الإجابة حساسة لحالة الأحرف
calc	0	يحدد ما إذا كانت CAPTCHA تتطلب حسابًا
lang	-	يحدد لغة CAPTCHA، راجع قائمة اللغات المدعومة
hintImg	-	صورة تلميح تظهر للعاملين مع CAPTCHA
hintText	-	نص تلميح/مهمة يظهر للعاملين مع CAPTCHA

مثال أساسي

يوضح المثال أدناه استدعاءً أساسيًا للحل مع معالجة الأخطاء.

cap := api2captcha.Normal{
   File: "/path/to/normal.jpg",
}

code, err := client.Solve(cap.ToRequest())
if err != nil {
  if err == api2captcha.ErrTimeout {
    log.Fatal("Timeout");
  } else if err == api2captcha.ErrApi {
    log.Fatal("API error");
  } else if err == api2captcha.ErrNetwork {
    log.Fatal("Network error");
  } else {
    log.Fatal(err);
  }
}
fmt.Println("code "+code)

لتجاوز CAPTCHA العادية (نص مشوّه داخل صورة) استخدم الطريقة التالية. يمكن أيضًا استخدام هذه الطريقة للتعرّف على أي نص داخل الصورة.

cap := api2captcha.Normal{
    File: "/path/to/normal.jpg",
    Numeric: 4,
    MinLen: 4,
    MaxLen: 20,
    Phrase: true,
    CaseSensitive: true,
    Lang: "en",
    HintImgFile: "/path/to/hint.jpg",
    HintText: "Type red symbols",
 }

يمكن استخدام هذه الطريقة لتجاوز CAPTCHA تتطلب الإجابة عن سؤال مقدّم كنص واضح.

cap := api2captcha.Text{
    Text: "If tomorrow is Saturday, what day is today?",
    Lang: "en",
 }

استخدم هذه الطريقة لحل reCAPTCHA V2 والحصول على token لتجاوز الحماية.

cap := api2captcha.ReCaptcha{
    SiteKey: "6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-",
    Url: "https://mysite.com/page/with/recaptcha",
    Invisible: true,
    Action: "verify",
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

توفر هذه الطريقة حلّال reCAPTCHA V3 وتُرجع token.

cap := api2captcha.ReCaptcha{
    SiteKey: "6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-",
    Url: "https://mysite.com/page/with/recaptcha",
    Version: "v3",
    Action: "verify",
    Score: 0.3,
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

طريقة حل FunCaptcha (Arkoselabs). تُرجع token.

cap := api2captcha.FunCaptcha{
    SiteKey: "69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC",
    Url: "https://mysite.com/page/with/funcaptcha",
    Surl: "https://client-api.arkoselabs.com",
    UserAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36",
    Data: map[string]string{"anyKey":"anyValue"},   
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

طريقة لحل GeeTest puzzle captcha. تُرجع مجموعة tokens بصيغة JSON.

cap := api2captcha.GeeTest{
    GT: "f2ae6cadcf7886856696502e1d55e00c",
    ApiServer: "api-na.geetest.com",
    Challenge: "12345678abc90123d45678ef90123a456b",
    Url: "https://mysite.com/captcha.html",
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

طريقة معتمدة على token لتجاوز Capy puzzle captcha.

cap := api2captcha.Capy{
    SiteKey: "PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v",
    Url: "https://www.mysite.com/captcha/",   
 }
 req := cap.ToRequest()
 req.SetProxy("HTTPS", "login:password@IP_address:PORT")
 code, err := client.solve(req)

طريقة Grid تُعرف أصلًا بطريقة reCAPTCHA V2 القديمة. يمكن استخدامها لتجاوز أي CAPTCHA يمكن تطبيق شبكة عليها وتحتاج للنقر على مربعات محددة. تُرجع أرقام المربعات.

cap := api2captcha.Grid{
    File: "path/to/captcha.jpg",
    Rows: 3,
    Cols: 3,
    PreviousId: 0,
    CanSkip: false,
    Lang: "en",
    HintImageFile: "path/to/hint.jpg",
    HintText: "Select all images with an Orange",
}

يمكن استخدام طريقة Canvas عندما تحتاج لرسم خط حول كائن في الصورة. تُرجع مجموعة إحداثيات نقاط لرسم مضلع.

cap := api2captcha.Canvas{
    File: "path/to/captcha.jpg",
    PreviousId: 0,
    CanSkip: false,
    Lang: "en",
    HintImageFile: "path/to/hint.jpg",
    HintText: "Draw around apple",
}

ترجع طريقة ClickCaptcha إحداثيات نقاط على صورة CAPTCHA. يمكن استخدامها إذا كنت بحاجة للنقر على نقاط محددة في الصورة.

cap := api2captcha.Coordinates{
    File: "path/to/captcha.jpg",
    Lang: "en",
    HintImageFile: "path/to/hint.jpg",
    HintText: "Connect the dots",
}

يمكن استخدام هذه الطريقة لحل CAPTCHA تطلب تدوير كائن. تُستخدم غالبًا لتجاوز FunCaptcha. تُرجع زاوية التدوير.

cap := api2captcha.Rotate{
    File: "path/to/captcha.jpg",
    Angle: 40,
    Lang: "en",
    HintImageFile: "path/to/hint.jpg",
    HintText: "Put the images in the correct way",
}

طرق أخرى

طرق إضافية صالحة تُستخدم أثناء عمل السكربتات الرئيسية

send / getResult

يمكن استخدام هذه الطرق لإرسال CAPTCHA يدويًا واستطلاع الإجابة.

id, err := client.Send(cap.ToRequest())
if err != nil {
   log.Fatal(err);
}

time.Sleep(10 * time.Second)

code, err := client.GetResult(id)
if err != nil {
   log.Fatal(err);
}

if code == nil {
   log.Fatal("Not ready")
}

fmt.Println("code "+*code)

balance

استخدم هذه الطريقة للحصول على رصيد حسابك.

balance, err := client.GetBalance()
if err != nil {
   log.Fatal(err);
}

report

استخدم هذه الطريقة للإبلاغ عن إجابة CAPTCHA جيدة أو سيئة.

err := client.Report(id, true) // solved correctly
err := client.Report(id, false) // solved incorrectly

تجاوز CAPTCHA باستخدام Go

التثبيت

GitHub

الإعداد

حل CAPTCHA

مثال أساسي

طرق أخرى

send / getResult

balance

report

لغات أخرى للتكامل مع API الخدمة

حزمة PHP للتكامل مع API الخدمة

حزمة Python للتكامل مع API الخدمة

حزمة Java للتكامل مع API الخدمة

حزمة C# للتكامل مع API الخدمة

حزمة Ruby للتكامل مع API الخدمة

حزمة JavaScript للتكامل مع API الخدمة