added task pushvariables feature

Author: imagetyperz-api

lib/imagetyperzapi.php

@@ -16,6 +16,7 @@
 define('TIKTOK_ENDPOINT', 'http://captchatypers.com/captchaapi/UploadTikTokCaptchaUser.ashx');
 define('FUNCAPTCHA_ENDPOINT', 'http://captchatypers.com/captchaapi/UploadFunCaptcha.ashx');
 define('TASK_ENDPOINT', 'http://captchatypers.com/captchaapi/UploadCaptchaTask.ashx');
+define('TASK_PUSH_ENDPOINT', 'http://captchatypers.com/CaptchaAPI/SaveCaptchaPush.ashx');
 
 define('CAPTCHA_ENDPOINT_CONTENT_TOKEN', 'http://captchatypers.com/Forms/UploadFileAndGetTextNEWToken.ashx');
 define('CAPTCHA_ENDPOINT_URL_TOKEN', 'http://captchatypers.com/Forms/FileUploadAndGetTextCaptchaURLToken.ashx');
@@ -521,6 +522,33 @@ function account_balance() {
 
         return '$' . $response;     // return response
     }
+    
+     // Push variables for task
+    function task_push_variables($captcha_id, $variables) {
+        // set data array
+        $data = array(
+            "action" => "GETTEXT",
+            "captchaid" => $captcha_id,
+            "pushVariables" => json_encode($variables)
+        );
+
+        if (!empty($this->_username)) {
+            $data["username"] = $this->_username;
+            $data["password"] = $this->_password;
+        } else {
+            $data['token'] = $this->_access_token;
+        }
+        $url = TASK_PUSH_ENDPOINT;
+
+        // do request
+        $response = Utils::post($url, $data, USER_AGENT, $this->_timeout);
+        // parse response
+        if (strpos($response, 'ERROR:') !== false) {
+            throw new Exception(trim(explode('ERROR:', $response)[1]));
+        }
+
+        return $response;     // return response
+    }
 
     // Set captcha bad
     function set_captcha_bad($captcha_id) {

readme.md

@@ -231,6 +231,19 @@ $params['variables'] = array(
 $captcha_id = $i->submit_task($params);
 ```
 
+#### Task pushVariable
+Update a variable value while task is running. Useful when dealing with 2FA authentication.
+
+When template reaches an action that uses a variable which wasn't provided with the submission of the task,
+task (while running on worker machine) will wait for variable to be updated through push.
+
+You can use the pushVariables method as many times as you need, even overwriting previously set variables.
+```php
+$i->task_push_variables($captcha_id, array(
+            "twofactor_code" => "39283"
+));
+```
+
 ## Retrieve response
 
 Regardless of the captcha type (and method) used in submission of the captcha, this method is used

task.php

@@ -24,6 +24,12 @@ function test_api() {
     //$params['user_agent'] = 'Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/60.0'; // - optional
     $captcha_id = $i->submit_task($params);
     echo "Waiting for captcha to be solved...\n";
+
+	// send pushVariable - update of variable while task is running (e.g 2FA code)
+	// $i->task_push_variables($Ccaptcha_id, array(
+    //         "twofactor_code" => "39283"
+    // ));
+    
     $response = null;
     while($response === null) {
         sleep(10);