en:objects:rucaptcha:functional:recognize

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:

<?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 = "0123456789abcdef0123456789abcdef";
 
//1
echo "1.Let's go to the polygon:";
echo $browser->navigate("http://www.humanemulator.net/poligon/image.html")."<br>";
 
//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()."<br>";
 
//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:7012"
from xweb_human_emulator import *
 
# Start
echo("<hr> <font color = blue> rucaptcha.xxxxxxxxx </font> <hr>")
 
# 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"), "<br>")
 
# 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", "<br>")
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(), "<br>")
 
# end
echo("<hr> <br>")
 
# 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("<hr> <font color = blue> rucaptcha.recognize </font> <hr>");
 
//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") + "<br>");
 
//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() + "<br>");
 
//end
echo("<hr> <br>");
 
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("<hr> <font color = blue> rucaptcha.recognize </font> <hr>");
 
//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") + "<br>");
 
//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() + "<br>");
 
//end
echo("<hr> <br>");
 
//Quit
app.quit();