Sidebar

en:objects:rucaptcha:functional:recognize_recaptcha_2_with_text

recognize_recaptcha_2_with_text

recognize_recaptcha_2_with_text($filename,$textinstructions); - recognize ReCaptcha2 with a text instruction. For more information, see here

It uses the following object fields :
  • $this->api_key - API key

    The function accepts parameters as input:

  • $filename – path to the captcha file
  • $textinstructions – text of what you need to specify (road signs, palm trees, gift, sign, etc.)

    Requirements for the captcha and the text:
  • The captcha itself must be either 300x300px, 600x600px, or 632x632px
  • The captcha size should be as it is, we will apply a grid of 9 squares to images 300x300, and we will apply a grid of 16 squares to images 600x600 and 632x632px
  • Captcha must be less than 100 KB
  • textinstructions must come in UTF-8 encoding
  • textinstructions must contain only what you need to select on the captcha

    After testing, the function returns the result of its work to the script :
  • The result of recognizing is a captcha in the response format: "OK|click:3/8/9/", where numbers are numbers of images similar to the specified one or a code string with an error response:
  • ERROR_KEY_DOES_NOT_EXIST - you used an invalid captcha key in the request
  • ERROR_WRONG_ID_FORMAT - invalid captcha ID, only numbers are accepted
  • ERROR_CAPTCHA_UNSOLVABLE - captcha could not be solved by 5 different employees

    PHP example:

    <?php $xhe_host = "127.0.0.1:7010";
     
    //connect the object to control the emulator, if not already connected
    if(!isset($path))
      $path = "../../../Templates/xweb_human_emulator.php";
    require($path);
     
    //Start
    echo "<hr> <font color = blue> rucaptcha->".basename(__FILE__)."</font> <hr>";
     
    //API key
    $rucaptcha->api_key = "";
     
    //1
    echo "1.Let's go to the polygon:";
    echo $browser->navigate("https://rucaptcha.com/support/faq/41/")."<br>";
     
    //2
    echo "2.Recognize a recaptcha with text instructions using the rucaptcha.com service:  n";
     
     
    //3
    echo "3.Display information:";
    echo $rucaptcha->get_last_capcha_filename()."";
    echo $rucaptcha->get_last_capcha_id()."";
    echo $rucaptcha->get_last_capcha_result()."<br>";
     
    //4
    echo "4.Set the default recognition parameters:";
    echo $rucaptcha->set_default_params();
     
    //end
    echo "<hr> <br>";
     
    //Quit
    $app->quit();
    ?>

    Python example:

    # Additional paths
    import sys
    sys.path.insert(0, '../../../Templates PY/')
     
    xhe_host = "127.0.0.1:7010"
    from xweb_human_emulator import *
     
    # Start
    echo("<hr> <font color = blue> rucaptcha.xxxxxxxxx </font> <hr>")
     
    # API key
    rucaptcha.api_key = ""
     
    # 1
    echo("1.Let's go to the polygon:")
    echo(browser.navigate("https://rucaptcha.com/support/faq/41/"), "<br>")
     
    # 2
    echo("2.Recaptcha with text instructions using rucaptcha.com service:
    ")
     
    # 3
    echo("3.Display information:")
    echo(rucaptcha.get_last_capcha_filename(), "")
    echo(rucaptcha.get_last_capcha_id(), "")
    echo(rucaptcha.get_last_capcha_result(), "<br>")
     
    # 4
    echo("4.Set the default recognition parameters:")
    echo(rucaptcha.set_default_params())
     
    # end
    echo("<hr> <br>")
     
    # Quit
    app.quit()

    C# example:

     

    Java Script example:

    //connect the object to control the emulator, if not already connected
    xhe_host = "127.0.0.1:7010";
    echo = require("../../../Templates JS/xweb_human_emulator.js");
     
    //Start
    echo("<hr> <font color = blue> rucaptcha.recognize_recaptcha_2_with_text </font> <hr>");
     
    //API key
    rucaptcha.api_key = "");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("https://rucaptcha.com/support/faq/41/") + "<br>");
     
    //step 2
    echo("2.Recaptcha with text instructions using the rucaptcha.com service:  n");
     
     
    //step 3
    echo("3.Display information:");
    echo(rucaptcha.get_last_capcha_filename() + "");
    echo(rucaptcha.get_last_capcha_id() + "");
    echo(rucaptcha.get_last_capcha_result() + "<br>");
     
    //step 4
    echo("4.Set the default recognition parameters:");
    echo(rucaptcha.set_default_params();
     
    //end
    echo("<hr> <br>");
     
    //Quit
    app.quit();
  • en/objects/rucaptcha/functional/recognize_recaptcha_2_with_text.txt · Last modified: 2026/08/05 22:47 (external edit)