ہوم ڈاکومنٹیشن ٹیوٹوریلز سائن ان
API طریقہ کار
سپورٹ کیے جانے والے ٹاسکس کی اقسام
آرٹیکلز
ٹیوٹوریلز
GitHub
ڈاکومنٹیشن مینو

Google Recaptcha v3 :RecaptchaV3TaskProxyless کو حل کریں

کسی کارکن کے کمپیوٹر پر Google Recaptcha V3 کو حل کرنے کے لیے اس قسم کے ٹاسک آبجیکٹ کی ضرورت ہوتی ہے۔ یہ ٹاسک ہماری سروس کے ذریعہ ہمارے اپنے پراکسی سرورز اور / یا کارکنوں کے IP پتوں کا استعمال کر کے انجام دیا جائے گا۔

براہ کرم نوٹ کریں کہ Recaptcha V2-غیر مرئی اور Recaptcha V3 میں فرق ہے۔ یہ ایک جیسے نظر آتے ہیں اور یہ مبہم ہو سکتا ہے۔ درست قسم کا تعین کرنے کا ایک تیز طریقہ موجود ہے: اسے ہماری API کے ساتھ بطور V2-غیر مرئی اور V3 حل کرنے کی کوشش کریں۔ کسی ایک کوشش میں آپ کو ایک خرابی کا سامنا ہوگا اور اگلی کوشش میں ایسا نہیں ہوگا۔

ہم اپنے کارکنوں کو ان کے recaptcha “اسکور” کے لیے ٹیسٹ کرتے ہیں اور انہیں 3 گروپوں (قطاروں) میں ڈال دیتے ہیں: 0.3 ،0.7 ،0.9۔ فارغ کارکنوں کی وجہ سے ہر ایک کی قیمت تھوڑی بہت مختلف ہوسکتی ہے۔ پراپرٹی minScore کو پاس کر کے آپ اس قطار کی نشاندہی کرتے ہیں جس میں آپ کا ٹاسک داخل ہوگا۔ ہمارے زیادہ تر دستیاب کارکنوں کا اسکور 0.3ہے اور کم سے کم میں 0.9ہے۔

Recaptcha V3 کے بارے میں مزید معلومات ان عمومی سوالات میں دیکھی جا سکتی ہیں۔

Recaptcha v3 کی ایک مثال۔ عام طور پر پیج کے نیچے دائیں کونے میں ایک لوگو بیج ہوتا ہے۔ یہ جاوا اسکرپٹ کی مدد سے آسانی سے ختم کیا جاسکتا ہے۔

ٹاسک آبجیکٹ

پراپرٹی قسم درکار ہے مقصد
type اسٹرنگ ہاں RecaptchaV3TaskProxyless
websiteURL اسٹرنگ ہاں مطلوبہ ویب پیج کا ایڈریس۔ ویب سائٹ پر کہیں بھی دیکھا جا سکتا ہے، یہاں تک کہ ممبر کے علاقے میں بھی۔ ہمارے کارکن وہاں نہیں جاتے، بلکہ اس کی بجائے اس دورے کو سیمولیٹ کرتے ہیں۔
websiteKey اسٹرنگ ہاں Recaptcha ویب سائٹ کی کلید۔ اس آرٹیکل میں اسے تلاش کرنے کے طریقے کے بارے میں جانیں۔
minScore ڈبل ہاں مطلوبہ اسکور والے کارکن کو فلٹر کرتا ہے۔ ویلیو مندرجہ ذیل میں سے کوئی ایک ہوسکتی ہے:
0.3
0.7
0.9
pageAction اسٹرنگ نہیں
Recaptcha کی “ایکشن” قدر۔ ویب سائٹ کا مالک وضاحت کرتا ہے کہ صارف اس پیرامیٹر کے ذریعے پیج پر کیا کر رہا ہے۔
مثال:

grecaptcha.execute('site_key', {action:'login_test'})
isEnterprise بُولین نہیں اگر آپ Enterprise API کے ذریعہ اس V3 کو حل کرنا چاہتے ہیں تو اس فلیگ کو “درست” پر سیٹ کریں۔ ڈیفالٹ ویلیو “غلط” ہے اور Recaptcha کو non-enterprise API کے ساتھ حل کیا جاتا ہے۔ جاوا اسکرپٹ کال کے ذریعہ مندرجہ ذیل مثال کی طرح تعین کیا جا سکتا ہے:

grecaptcha.enterprise.execute('site_key', {..})
apiDomain اسٹرنگ نہیں اس پیرامیٹر کا استعمال اس ڈومین نام کو بھیجنے کے لیے کریں جہاں سے Recaptcha اسکرپٹ پیش کیا جانا چاہیے۔ دو میں سے صرف ایک قدر ہو سکتی ہے: "www.google.com" یا "www.recaptcha.net"۔ اس پیرامیٹر کا استعمال نہ کریں جب تک کہ آپ یہ نہ سمجھیں کہ آپ کیا کر رہے ہیں۔

درخواست کی مثال

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY_HERE",
    "task":
        {
            "type":"RecaptchaV3TaskProxyless",
            "websiteURL":"http://mywebsite.com/recaptcha/test.php",
            "websiteKey":"6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16",
            "minScore": 0.3,
            "pageAction": "myverify",
            "isEnterprise": false
        },
    "softId": 0
}' https://api.anti-captcha.com/createTask
        
PHP
          <?php

//git clone git@github.com:AdminAnticaptcha/anticaptcha-php.git

include("anticaptcha.php");
include("recaptchaV3.php");

$api = new RecaptchaV3();
$api->setVerboseMode(true);

//your anti-captcha.com account key
$api->setKey("YOUR_API_KEY_HERE");

//target website address
$api->setWebsiteURL("http://makeawebsitehub.com/recaptcha/test.php");

//recaptcha key from target website
$api->setWebsiteKey("6LfI9IsUAAAAAKuvopU0hfY8pWADfR_mogXokIIZ");

//parameters for V3
//score you would like to have
$api->setMinScore(0.9);
//optional page action
$api->setPageAction("some_action");

//Specify softId to earn 10% commission with your app.
//Get your softId here: https://anti-captcha.com/clients/tools/devcenter
$api->setSoftId(0);

//create task in API
if (!$api->createTask()) {
    $api->debout("API v2 send failed - ".$api->getErrorMessage(), "red");
    return false;
}

$taskId = $api->getTaskId();

//wait in a loop for max 300 seconds till task is solved
if (!$api->waitForResult(300)) {
    echo "could not solve captcha\n";
    echo $api->getErrorMessage()."\n";
} else {

    $gResponse    =   $api->getTaskSolution();
    echo "\n";
    echo "your recaptcha token: $gResponse\n\n";

    //check result, then:
    $api->reportCorrectRecaptcha();
    //or
    //$api->reportIncorrectRecaptcha();

}
        
Python
          #pip3 install anticaptchaofficial

from anticaptchaofficial.recaptchav3proxyless import *

solver = recaptchaV3Proxyless()
solver.set_verbose(1)
solver.set_key("YOUR_API_KEY_HERE")
solver.set_website_url("https://website.com")
solver.set_website_key("SITE_KEY")
solver.set_page_action("home_page")
solver.set_min_score(0.9)

# Specify softId to earn 10% commission with your app.
# Get your softId here: https://anti-captcha.com/clients/tools/devcenter
solver.set_soft_id(0)

g_response = solver.solve_and_return_solution()
if g_response != 0:
    print "g-response: "+g_response
else:
    print "task finished with error "+solver.error_code
        
NodeJS
          //npm -i @antiadmin/anticaptchaofficial
//https://github.com/AdminAnticaptcha/anticaptcha-npm

const ac = require("@antiadmin/anticaptchaofficial");

ac.setAPIKey('YOUR_API_KEY_HERE');

//Specify softId to earn 10% commission with your app.
//Get your softId here: https://anti-captcha.com/clients/tools/devcenter
ac.setSoftId(0);

ac.solveRecaptchaV3('http://DOMAIN.COM',
    'WEBSITE_KEY',
    0.3, //minimum score required: 0.3, 0.7 or 0.9
    'PAGE_ACTION_CAN_BE_EMPTY')
    .then(gresponse => {
        console.log('g-response: '+gresponse);
    })
    .catch(error => console.log('test received error '+error));

        
C#
          //git clone git@github.com:AdminAnticaptcha/anticaptcha-csharp

using System;
using Anticaptcha_example.Api;
using Anticaptcha_example.Helper;
using Newtonsoft.Json.Linq;

namespace Anticaptcha_example
{
    internal class Program
    {
        private static void Main() {

            DebugHelper.VerboseMode = true;

            var api = new RecaptchaV3Proxyless
            {
                ClientKey = "YOUR_API_KEY_HERE",
                WebsiteUrl = new Uri("http://makeawebsitehub.com/recaptcha/test.php"),
                WebsiteKey = "6LfI9IsUAAAAAKuvopU0hfY8pWADfR_mogXokIIZ",
                PageAction = "login_or_register",
                IsEnterprise = false,

                // Specify softId to earn 10% commission with your app.
                // Get your softId here:
                // https://anti-captcha.com/clients/tools/devcenter
                SoftId = 0
            };
            api.MinScore(0.3)

            if (!api.CreateTask())
                DebugHelper.Out("API v2 send failed. " + api.ErrorMessage, DebugHelper.Type.Error);
            else if (!api.WaitForResult())
                DebugHelper.Out("Could not solve the captcha.", DebugHelper.Type.Error);
            else
                DebugHelper.Out("Result: " + api.GetTaskSolution().GRecaptchaResponse, DebugHelper.Type.Success);

        }
    }
}

        
Java
          //git clone git@github.com:AdminAnticaptcha/anticaptcha-java.git

DebugHelper.setVerboseMode(true);

RecaptchaV3Proxyless api = new RecaptchaV3Proxyless();
api.setClientKey("YOUR_API_KEY_HERE");
api.setWebsiteUrl(new URL("http://getcaptchajob.com/"));
api.setWebsiteKey("6LfE4ZIUAAAAAGSYvvoszRvEC9IgFVyXwGkypn-W");
api.setPageAction("testPageAction");
api.setMinScore(0.9);

//Specify softId to earn 10% commission with your app.
//Get your softId here: https://anti-captcha.com/clients/tools/devcenter
api.setSoftId(0);

if (!api.createTask()) {
    DebugHelper.out(
            "API v2 send failed. " + api.getErrorMessage(),
            DebugHelper.Type.ERROR
    );
} else if (!api.waitForResult()) {
    DebugHelper.out("Could not solve the captcha.", DebugHelper.Type.ERROR);
} else {
    DebugHelper.out("Result: " + api.getTaskSolution().getGRecaptchaResponse(), DebugHelper.Type.SUCCESS);
}
        

جواب کی مثال

خرابیوں کے بغیر JSON
          {
    "errorId": 0,
    "taskId": 7654321
}
        
خرابیوں کے ساتھ JSON
          {
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}
        

حل بازیافت کریں

حل کی درخواست کرنے کے لیے طریقہ کار getTaskResult استعمال کریں۔ پہلی درخواست بھیجنے سے پہلے کارکن کو کچھ وقت دیں، جیسے 5 سیکنڈ۔ اگر کارکن ابھی بھی مصروف ہے تو 3 سیکنڈ میں دوبارہ کوشش کریں۔

ٹاسک کے حل کا آبجیکٹ

پراپرٹی قسم مقصد
gRecaptchaResponse اسٹرنگ ٹوکن اسٹرنگ جو مطلوبہ ویب سائٹ پر جمع کروانے کے فارم کے ساتھ تعامل کے لیے درکار ہوتا ہے۔

جواب کی مثال

خرابیوں کے بغیر JSON
          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}