# MetaBypass ( AI Captcha Solver )
## PHP class to work with MetaBypass services

<br/>

### Features

Solve image captcha , reCaptcha v2 & v3 <br/>
Auto handler for reCaptcha v2 <br/> 
Simple syntax <br/>
Error logger <br/>

<br/>
<br/>

## Install via composer

Go to your project root directory and run this command in terminal: 

<br/>

```
composer require metabypass/php
```

<br/>
<br/>


## Usage
 
<br/>

**Image Captcha** <br />
 ```PHP
<?php

use Metabypass\Metabypass;

require 'vendor/autoload.php';

//---------------------- CONFGURATION ---------------------------

//get your credentials from https://app.metabypass.tech/application
$clientId='YOUR_CLIENT_ID'; 
$clientSecret='YOUR_CLIENT_SECRET';
$email='YOUR_EMAIL';
$password='YOUR_PASSWORD';

//metabypass instance 
$metabypass=new Metabypass($clientId,$clientSecret,$email,$password);


//-------------------- IMAGE CAPTCHA SOLVER ---------------------------

// you can pass base64 encoded image file or path of image file
//$image='base64_encoded_image';
$image='./samples/icaptcha2.png';
//you can pass some optional params too. more details: https://app.metabypass.tech/docs.html?#api_3
$numeric=0; //default
$minLen=0;  //default
$maxLen=0;  //default

$server_response=$metabypass->imageCaptcha($image,$numeric,$minLen,$maxLen); //complete response in an object 
var_dump($metabypass->imageCaptcha_result); //end result

 ```
<br/><br/>

**reCaptcha v2** <br />
 ```PHP
<?php

use Metabypass\Metabypass;

require 'vendor/autoload.php';

//---------------------- CONFGURATION ---------------------------

//get your credentials from https://app.metabypass.tech/application
$clientId='YOUR_CLIENT_ID'; 
$clientSecret='YOUR_CLIENT_SECRET';
$email='YOUR_EMAIL';
$password='YOUR_PASSWORD';

//metabypass instance 
$metabypass=new Metabypass($clientId,$clientSecret,$email,$password);

//-------------------- reCAPTCHA v2 ---------------------------
$url='SITE_URL';
$siteKey='SITE_KEY';
$server_response=$metabypass->reCaptchaV2Handler($url,$siteKey); //complete response in an object 
var_dump($metabypass->reCaptchaV2_result); //end result

 ```
<br/><br/>


**reCaptcha v3** <br />
 ```PHP
<?php

use Metabypass\Metabypass;

require 'vendor/autoload.php';

//---------------------- CONFGURATION ---------------------------

//get your credentials from https://app.metabypass.tech/application
$clientId='YOUR_CLIENT_ID'; 
$clientSecret='YOUR_CLIENT_SECRET';
$email='YOUR_EMAIL';
$password='YOUR_PASSWORD';

//metabypass instance 
$metabypass=new Metabypass($clientId,$clientSecret,$email,$password);


//-------------------- reCAPTCHA v3 ---------------------------
$url='SITE_URL';
$siteKey='SITE_KEY';
$metabypass->reCaptchaV3($url,$siteKey); //complete response in an object 
var_dump($metabypass->reCaptchaV3_result); //end result
 ```
<br/><br/>