added turnstile captcha ; added custom domain for reCAPTCHA and hCaptcha

Author: imagetyperz-api

Diff for: hcaptcha.php

@@ -17,6 +17,9 @@ function test_api() {
     $params['sitekey'] = '1c7062c7-cae6-4e12-96fb-303fbec7fe4f';
     //$params['invisible'] = '1';  // if captcha is invisible - optional
 
+    // domain used in loading of hcaptcha interface, default: hcaptcha.com - optional
+    // $params['domain'] = 'hcaptcha.com';
+
     // extra parameters, useful for enterprise
     // submit userAgent from requests too, when this is used
     // $params['HcaptchaEnterprise'] = array(

Diff for: lib/imagetyperzapi.php

@@ -15,6 +15,7 @@
 define('HCAPTCHA_ENDPOINT', 'http://captchatypers.com/captchaapi/UploadHCaptchaUser.ashx');
 define('TIKTOK_ENDPOINT', 'http://captchatypers.com/captchaapi/UploadTikTokCaptchaUser.ashx');
 define('FUNCAPTCHA_ENDPOINT', 'http://captchatypers.com/captchaapi/UploadFunCaptcha.ashx');
+define('TURNSTILE_ENDPOINT', 'http://captchatypers.com/captchaapi/Uploadturnstile.ashx');
 define('TASK_ENDPOINT', 'http://captchatypers.com/captchaapi/UploadCaptchaTask.ashx');
 define('TASK_PUSH_ENDPOINT', 'http://captchatypers.com/CaptchaAPI/SaveCaptchaPush.ashx');
 
@@ -178,6 +179,7 @@ function submit_recaptcha($d) {
                 $data['enterprise_type'] = 'v3';
             }
         }
+        if (isset($d['domain'])) $data["domain"] = $d['domain'];
         if (isset($d['v3_action'])) $data["captchaaction"] = $d['v3_action'];
         if (isset($d['v3_min_score'])) $data["score"] = (string)$d['v3_min_score'];
         if (isset($d['data-s'])) $data["data-s"] = (string)$d['data-s'];
@@ -343,6 +345,7 @@ function submit_hcaptcha($d) {
         }
         // check for user agent
         if (isset($d['user_agent'])) $data["useragent"] = $d['user_agent'];
+        if (isset($d['domain'])) $data["apiEndpoint"] = $d['domain'];
         $response = Utils::post(HCAPTCHA_ENDPOINT, $data, USER_AGENT, $this->_timeout);
         if (strpos($response, 'ERROR:') !== false) {
             throw new Exception(trim(explode('ERROR:', $response)[1]));
@@ -429,6 +432,43 @@ function submit_funcaptcha($d) {
         return json_decode($response, true)[0]['CaptchaId'];
     }
 
+    function submit_turnstile($d) {
+        $data = array(
+            "action" => "UPLOADCAPTCHA",
+            "pageurl" => $d['page_url'],
+            "sitekey" => $d['sitekey'],
+        );
+
+        if (!empty($this->_username)) {
+            $data["username"] = $this->_username;
+            $data["password"] = $this->_password;
+        } else {
+            $data['token'] = $this->_access_token;
+        }
+
+        // affiliate
+        if (!empty($this->_affiliate_id)) {
+            $data['affiliateid'] = $this->_affiliate_id;
+        }
+
+        // check for proxy
+        if (isset($d['proxy'])) {
+            // we have a good proxy here (at least both params supplied)
+            // set it to the data/params
+            $data["proxy"] = $d['proxy'];
+        }
+        // check for user agent
+        if (isset($d['user_agent'])) $data["useragent"] = $d['user_agent'];
+        if (isset($d['domain'])) $data["apiEndpoint"] = $d['domain'];
+        if (isset($d['action'])) $data["taction"] = $d['action'];
+        if (isset($d['cdata'])) $data["data"] = $d['cdata'];
+        $response = Utils::post(TURNSTILE_ENDPOINT, $data, USER_AGENT, $this->_timeout);
+        if (strpos($response, 'ERROR:') !== false) {
+            throw new Exception(trim(explode('ERROR:', $response)[1]));
+        }
+        return json_decode($response, true)[0]['CaptchaId'];
+    }
+
     function submit_task($d) {
         $d['captchatype'] = '16';
         $d['action'] = 'UPLOADCAPTCHA';

Diff for: readme.md

@@ -71,6 +71,7 @@ For recaptcha submission there are two things that are required.
     - `3` - v3
     - `4` - enterprise v2
     - `5` - enterprise v3
+- domain - used in loading of reCAPTCHA interface, default: `www.google.com` (alternative: `recaptcha.net`) - `optional`
 - v3_min_score - minimum score to target for v3 recaptcha `- optional`
 - v3_action - action parameter to use for v3 recaptcha `- optional`
 - proxy - proxy to use when solving recaptcha, eg. `12.34.56.78:1234` or `12.34.56.78:1234:user:password` `- optional`
@@ -84,6 +85,7 @@ $params = array();
 $params['page_url'] = 'page_url_here';
 $params['sitekey'] = 'sitekey_here';
 // $params['type'] = 1;    // optional
+// $params['domain'] = 'www.google.com';  // used in loading reCAPTCHA interface, default: www.google.com (alternative: recaptcha.net) - optional
 // $params['v3_min_score'] = 0.3;          // min score to target when solving v3 - optional
 // $params['v3_action'] = 'homepage';      // action to use when solving v3 - optional
 // $params['proxy'] = '126.45.34.53:123';  // - optional
@@ -161,6 +163,9 @@ $params['page_url'] = 'https://your-site.com';
 $params['sitekey'] = '1c7062c7-cae6-4e12-96fb-303fbec7fe4f';
 //$params['invisible'] = '1';  // if captcha is invisible - optional
 
+// domain used in loading of hcaptcha interface, default: hcaptcha.com - optional
+// $params['domain'] = 'hcaptcha.com';
+    
 // extra parameters, useful for enterprise
 // submit userAgent from requests too, when this is used
 // $params['HcaptchaEnterprise'] = array(
@@ -213,6 +218,22 @@ $params['data'] = '{"a":"b"}';
 $captcha_id = $i->submit_funcaptcha($params);
 ```
 
+### Turnstile (Cloudflare)
+
+Requires page_url, sitekey
+
+```php
+$params = array();
+$params['page_url'] = 'https://your-site.com';
+$params['sitekey'] = '0x4ABBBBAABrfvW5vKbx11FZ';
+//$params['domain'] = 'challenges.cloudflare.com';         // domain used in loading turnstile interface, default: challenges.cloudflare.com - optional
+//$params['action'] = 'homepage';                          // used in loading turnstile interface, similar to reCAPTCHA - optional
+//$params['cdata'] = 'your cdata';                         // used in loading turnstile interface - optional
+//$params['proxy'] = '126.45.34.53:123';  // - optional
+//$params['user_agent'] = 'Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/60.0'; // - optional
+$captcha_id = $i->submit_turnstile($params);
+```
+
 ### Task
 
 Requires template_name, pageurl and usually variables
@@ -269,8 +290,7 @@ The response is a JSON object that looks like this:
   "CaptchaId": 176707908, 
   "Response": "03AGdBq24PBCbwiDRaS_MJ7Z...mYXMPiDwWUyEOsYpo97CZ3tVmWzrB", 
   "Cookie_OutPut": "", 
-  "Proxy_reason": "", 
-  "Recaptcha score": 0.0, 
+  "Proxy_reason": "",
   "Status": "Solved"
 }
 ```

Diff for: recaptcha.php

@@ -26,6 +26,7 @@ function test_api() {
     //
     //$params['type'] = 1;    // optional
     //
+    //$params['domain'] = 'www.google.com';  // used in loading reCAPTCHA interface, default: www.google.com (alternative: recaptcha.net) - optional
     //$params['v3_min_score'] = 0.3;          // min score to target when solving v3 - optional
     //$params['v3_action'] = 'homepage';      // action to use when solving v3 - optional
     // proxy to use when solving recaptcha, works with auth as well 126.45.34.53:123:user:password

Diff for: turnstile.php

@@ -0,0 +1,44 @@
+#!/usr/bin/php
+
+<?php
+require('lib/imagetyperzapi.php');      // load API library
+
+function test_api() {
+    # grab token from https://imagetyperz.com
+    $access_token = 'your_access_token';
+    $i = new ImagetyperzAPI($access_token);      // init API lib obj
+
+    $balance = $i->account_balance();       // get balance
+    echo "Balance: $balance\n";
+
+    echo "Solving captcha ...\n";
+    $params = array();
+    $params['page_url'] = 'https://your-site.com';
+    $params['sitekey'] = '0x4ABBBBAABrfvW5vKbx11FZ';
+    //$params['domain'] = 'challenges.cloudflare.com';         // domain used in loading turnstile interface, default: challenges.cloudflare.com - optional
+    //$params['action'] = 'homepage';                          // used in loading turnstile interface, similar to reCAPTCHA - optional
+    //$params['cdata'] = 'your cdata';                         // used in loading turnstile interface - optional
+    //$params['proxy'] = '126.45.34.53:123';  // - optional
+    //$params['user_agent'] = 'Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/60.0'; // - optional
+    $captcha_id = $i->submit_turnstile($params);
+    echo "Waiting for captcha to be solved...\n";
+    $response = null;
+    while($response === null) {
+        sleep(10);
+        $response = $i->retrieve_response($captcha_id);
+    }
+    echo "Response: ";
+    var_dump($response);
+}
+
+// Main method
+function main() {
+    try {
+        test_api();             // test API
+    } catch (Exception $ex) {
+        echo "Error occurred: " . $ex->getMessage();     // print error
+    }
+}
+
+main();         // run main function
+?>