recognize

recognize($filename, $apikey, $path ='http://www.rucaptcha.com', $is_verbose = true, $rtimeout = 5, $mtimeout = 120, $is_phrase = 0, $is_regsense = 0, $is_numeric = 0, $min_len = 0, $max_len = 0,$is_russian = 0); - recognize captcha from the specified file

The function accepts parameters as input:

  • $filename – path to the captcha file
  • $apikey – key for identification on the service
  • $path – path to the service
  • $is_verbose - enable/disable verbose mode :false(disable), true(enable)
  • $rtimeout - delay between captcha status polls
  • $mtimeout - waiting time for captcha input
  • $is_phrase - 0 or 1 - flag "2 or more words in captcha"
  • $is_regsense - 0 or 1 - flag "case of letters in captcha has the value"
  • $is_numeric - 0 or 1 - flag "captcha consists only of digits"
  • $min_len - 0 (unlimited), any other digit indicates the minimum length of the captcha text
  • $max_len - 0 (unlimited), any other digit indicates the maximum length of the captcha text
  • $is_russian - 0 or 1 - flag "captcha should only be shown to Russian-speaking employees"

    Example:

    $text=recognize("/path/to/file/captcha.jpg","your_admin_key",true);

    $text=recognize("/path/to/file/captcha.jpg","your_admin_key", false); //comment disabled

    $text=recognize("/path/to/file/captcha.jpg","your_admin_key",false,1,0,0,5); //comments disabled, captcha consists of two words, the total minimum length is 5 characters

    After testing, the function returns the result of its work to the script :
  • The result of recognizing is a captcha 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: rucaptcha->".basename(__FILE__)."
    "; //API key $rucaptcha->api_key = "0123456789abcdef0123456789abcdef"; //1 echo "1.Let's go to the polygon:"; echo $browser->navigate("http://www.humanemulator.net/poligon/image.html")."
    "; //2 echo "2.Recognize captcha using rucaptcha.com service(as numbers):"; echo $image->screenshot_by_src("tmp/1.jpg", "images/captcha", false).""; echo $rucaptcha->recognize($debug->get_cur_script_folder()."tmp \ 1.jpg", $rucaptcha->api_key, "http://www.rucaptcha.com", true, 5,120,0,0, 1)." N"; //3 echo "3.Display information:"; echo $rucaptcha->get_last_capcha_filename().""; echo $rucaptcha->get_last_capcha_id().""; echo $rucaptcha->get_last_capcha_result()."
    "; //end echo "

    "; //Quit $app->quit(); ?>
    Python example: # Additional paths import sys sys.path.insert(0, '../../../Templates PY/') xhe_host = "127.0.0.1:7012" from xweb_human_emulator import * # Start echo("
    rucaptcha.xxxxxxxxx
    ") # API key rucaptcha.api_key = "0123456789abcdef0123456789abcdef" # 1 echo("1.Let's go to the polygon:") echo(browser.navigate("http://www.humanemulator.net/poligon/image.html"), "
    ") # 2 echo("2.Recognize captcha using rucaptcha.com service(as numbers):") echo(image.screenshot_by_src(debug.get_cur_script_folder() + "tmp \ 1.jpg", "images/captcha", false), "") echo(debug.get_cur_script_folder() + "tmp \ 1.jpg", "
    ") echo(rucaptcha.recognize(debug.get_cur_script_folder() + "tmp \ 1.jpg", rucaptcha.api_key, "http://www.rucaptcha.com", true, 5,120,0,0,1), " ") # 3 echo("3.Display information:") echo(rucaptcha.get_last_capcha_filename(), "") echo(rucaptcha.get_last_capcha_id(), "") echo(rucaptcha.get_last_capcha_result(), "
    ") # end echo("

    ") # Quit app.quit()
    C# example: #region using using System; using System.Diagnostics; using System.Collections.Generic; using System.Linq; using System.IO; using System.Text; using System.Threading; using XHE; using XHE.XHE_DOM; using XHE.XHE_System; using XHE.XHE_Window; using XHE.XHE_Web; #endregion class Program: XHEScript { static void Main(string [] args) { //init XHE server = "127.0.0.1:7010"; InitXHE(); //Start echo("
    rucaptcha.recognize
    "); //API key rucaptcha.api_key = "448b2d538fef6c236092492a947123af85b"; //1 echo("1.Let's go to the polygon:"); echo(browser.navigate("http://www.humanemulator.net/poligon/image.html") + "
    "); //2 echo("2.Recognize a captcha using the rucaptcha.com service(as numbers):"); echo(image.screenshot_by_src("tmp/1.jpg", "images/captcha", 0) + ""); echo(rucaptcha.recognize(debug.get_cur_script_folder() + "tmp \ 1.jpg", rucaptcha.api_key, "http://www.rucaptcha.com", true, 5,120, false, false, true) + " n "); //3 echo("3.Display information:"); echo(rucaptcha.get_last_capcha_filename() + ""); echo(rucaptcha.get_last_capcha_id() + ""); echo(rucaptcha.get_last_capcha_result() + "
    "); //end echo("

    "); app.quit(); } }
    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("
    rucaptcha.recognize
    "); //API key rucaptcha.api_key = ""); //1 step echo("1.Let's go to the polygon:"); echo(browser.navigate("http://www.humanemulator.net/poligon/image.html") + "
    "); //step 2 echo("2.Recognize captcha using rucaptcha.com service(as numbers):"); echo(image.screenshot_by_src("tmp/1.jpg", "images/captcha", false) + ""); echo(rucaptcha.recognize(debug.get_cur_script_folder()."tmp \ 1.jpg", rucaptcha.api_key, "http://www.rucaptcha.com", true, 5,120,0,0,1) + " 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() + "
    "); //end echo("

    "); //Quit app.quit();