2captcha-python 1.4.0__tar.gz → 1.5.0__tar.gz

{2captcha_python-1.4.0 → 2captcha_python-1.5.0}/2captcha_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: 2captcha-python
-Version: 1.4.0
+Version: 1.5.0
 Summary: Python module for easy integration with 2Captcha API
 Home-page: https://github.com/2captcha/2captcha-python/
 Author: 2Captcha
@@ -64,7 +64,7 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [Datadome](#datadome)
     - [CyberSiARA](#cybersiara)
   - [Other methods](#other-methods)
-    - [send / get_result](#send--get_result)
+    - [send / get\_result](#send--get_result)
     - [balance](#balance)
     - [report](#report)
   - [Error handling](#error-handling)
@@ -73,10 +73,10 @@ Examples of API requests for different captcha types are available on the [Pytho
   - [Examples](#examples)
   - [Examples using Selenium](#examples-using-selenium)
   - [Useful articles](#useful-articles)
-- [Get in touch](#get-in-touch)
-- [Join the team 👪](#join-the-team-)
-- [License](#license)
-  - [Graphics and Trademarks](#graphics-and-trademarks)
+  - [Get in touch](#get-in-touch)
+  - [Join the team 👪](#join-the-team-)
+  - [License](#license)
+    - [Graphics and Trademarks](#graphics-and-trademarks)
 
 ## Installation
 
@@ -121,6 +121,8 @@ solver = TwoCaptcha(**config)
 | defaultTimeout   | 120            | Polling timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from the `res.php` API endpoint |
 | recaptchaTimeout | 600            | Polling timeout for reCAPTCHA in seconds. Defines how long the module tries to get the answer from the `res.php` API endpoint                          |
 | pollingInterval  | 10             | Interval in seconds between requests to the `res.php` API endpoint. Setting values less than 5 seconds is not recommended                              |
+| extendedResponse | None           | Set to `True` to get the response with additional fields or in more practical format (enables `JSON` response from `res.php` API endpoint). Suitable for [hCaptcha](#hcaptcha), [ClickCaptcha](#clickcaptcha), [Canvas](#canvas) |
+
 
 > [!IMPORTANT]
 > Once `callback` is defined for the `TwoCaptcha` instance, all methods return only the captcha ID and DO NOT poll the API to get the result. The result will be sent to the callback URL.

{2captcha_python-1.4.0 → 2captcha_python-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: 2captcha-python
-Version: 1.4.0
+Version: 1.5.0
 Summary: Python module for easy integration with 2Captcha API
 Home-page: https://github.com/2captcha/2captcha-python/
 Author: 2Captcha
@@ -64,7 +64,7 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [Datadome](#datadome)
     - [CyberSiARA](#cybersiara)
   - [Other methods](#other-methods)
-    - [send / get_result](#send--get_result)
+    - [send / get\_result](#send--get_result)
     - [balance](#balance)
     - [report](#report)
   - [Error handling](#error-handling)
@@ -73,10 +73,10 @@ Examples of API requests for different captcha types are available on the [Pytho
   - [Examples](#examples)
   - [Examples using Selenium](#examples-using-selenium)
   - [Useful articles](#useful-articles)
-- [Get in touch](#get-in-touch)
-- [Join the team 👪](#join-the-team-)
-- [License](#license)
-  - [Graphics and Trademarks](#graphics-and-trademarks)
+  - [Get in touch](#get-in-touch)
+  - [Join the team 👪](#join-the-team-)
+  - [License](#license)
+    - [Graphics and Trademarks](#graphics-and-trademarks)
 
 ## Installation
 
@@ -121,6 +121,8 @@ solver = TwoCaptcha(**config)
 | defaultTimeout   | 120            | Polling timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from the `res.php` API endpoint |
 | recaptchaTimeout | 600            | Polling timeout for reCAPTCHA in seconds. Defines how long the module tries to get the answer from the `res.php` API endpoint                          |
 | pollingInterval  | 10             | Interval in seconds between requests to the `res.php` API endpoint. Setting values less than 5 seconds is not recommended                              |
+| extendedResponse | None           | Set to `True` to get the response with additional fields or in more practical format (enables `JSON` response from `res.php` API endpoint). Suitable for [hCaptcha](#hcaptcha), [ClickCaptcha](#clickcaptcha), [Canvas](#canvas) |
+
 
 > [!IMPORTANT]
 > Once `callback` is defined for the `TwoCaptcha` instance, all methods return only the captcha ID and DO NOT poll the API to get the result. The result will be sent to the callback URL.

{2captcha_python-1.4.0 → 2captcha_python-1.5.0}/README.md

@@ -44,7 +44,7 @@ Examples of API requests for different captcha types are available on the [Pytho
     - [Datadome](#datadome)
     - [CyberSiARA](#cybersiara)
   - [Other methods](#other-methods)
-    - [send / get_result](#send--get_result)
+    - [send / get\_result](#send--get_result)
     - [balance](#balance)
     - [report](#report)
   - [Error handling](#error-handling)
@@ -53,10 +53,10 @@ Examples of API requests for different captcha types are available on the [Pytho
   - [Examples](#examples)
   - [Examples using Selenium](#examples-using-selenium)
   - [Useful articles](#useful-articles)
-- [Get in touch](#get-in-touch)
-- [Join the team 👪](#join-the-team-)
-- [License](#license)
-  - [Graphics and Trademarks](#graphics-and-trademarks)
+  - [Get in touch](#get-in-touch)
+  - [Join the team 👪](#join-the-team-)
+  - [License](#license)
+    - [Graphics and Trademarks](#graphics-and-trademarks)
 
 ## Installation
 
@@ -101,6 +101,8 @@ solver = TwoCaptcha(**config)
 | defaultTimeout   | 120            | Polling timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from the `res.php` API endpoint |
 | recaptchaTimeout | 600            | Polling timeout for reCAPTCHA in seconds. Defines how long the module tries to get the answer from the `res.php` API endpoint                          |
 | pollingInterval  | 10             | Interval in seconds between requests to the `res.php` API endpoint. Setting values less than 5 seconds is not recommended                              |
+| extendedResponse | None           | Set to `True` to get the response with additional fields or in more practical format (enables `JSON` response from `res.php` API endpoint). Suitable for [hCaptcha](#hcaptcha), [ClickCaptcha](#clickcaptcha), [Canvas](#canvas) |
+
 
 > [!IMPORTANT]
 > Once `callback` is defined for the `TwoCaptcha` instance, all methods return only the captcha ID and DO NOT poll the API to get the result. The result will be sent to the callback URL.

{2captcha_python-1.4.0 → 2captcha_python-1.5.0}/twocaptcha/__init__.py

@@ -12,4 +12,4 @@ support@2captcha.com
 """
 
 __author__ = '2captcha'
-__version__ = '1.4.0'
+__version__ = '1.5.0'

{2captcha_python-1.4.0 → 2captcha_python-1.5.0}/twocaptcha/solver.py

@@ -41,7 +41,8 @@ class TwoCaptcha():
                  defaultTimeout=120,
                  recaptchaTimeout=600,
                  pollingInterval=10,
-                 server = '2captcha.com'):
+                 server = '2captcha.com',
+                 extendedResponse=None):
 
         self.API_KEY = apiKey
         self.soft_id = softId
@@ -52,6 +53,7 @@ class TwoCaptcha():
         self.api_client = ApiClient(post_url = str(server))
         self.max_files = 9
         self.exceptions = SolverExceptions
+        self.extendedResponse = extendedResponse
 
     def normal(self, file, **kwargs):
         '''Wrapper for solving a normal captcha (image).
@@ -875,14 +877,23 @@ class TwoCaptcha():
         result = {'captchaId': id_}
 
         if self.callback is None:
-
             timeout = float(timeout or self.default_timeout)
             sleep = int(polling_interval or self.polling_interval)
 
             code = self.wait_result(id_, timeout, sleep)
-            result.update({'code': code})
 
-        return result
+            if self.extendedResponse == True:
+
+                new_code = {
+                    key if key != 'request' else 'code': value
+                    for key, value in code.items()
+                    if key != 'status'
+                }
+                result.update(new_code)
+            else:
+                result.update({'code': code})
+
+            return result
 
     def wait_result(self, id_, timeout, polling_interval):
 
@@ -944,6 +955,7 @@ class TwoCaptcha():
         return response[3:]
 
     def get_result(self, id_):
+        import json
         """This method can be used for manual captcha answer polling.
 
         Parameters
@@ -955,15 +967,31 @@ class TwoCaptcha():
         answer : text
         """
 
-        response = self.api_client.res(key=self.API_KEY, action='get', id=id_)
+        if self.extendedResponse == True:
 
-        if response == 'CAPCHA_NOT_READY':
-            raise NetworkException
+            response = self.api_client.res(key=self.API_KEY, action='get', id=id_, json=1)
 
-        if not response.startswith('OK|'):
-            raise ApiException(f'cannot recognize response {response}')
+            response_data = json.loads(response)
 
-        return response[3:]
+            if response_data.get("status") == 0:
+                raise NetworkException
+
+            if not response_data.get("status") == 1:
+                raise ApiException(f'Unexpected status in response: {response_data}')
+
+            return response_data
+
+        else:
+
+            response = self.api_client.res(key=self.API_KEY, action='get', id=id_)
+
+            if response == 'CAPCHA_NOT_READY':
+                raise NetworkException
+
+            if not response.startswith('OK|'):
+                raise ApiException(f'cannot recognize response {response}')
+
+            return response[3:]
 
     def balance(self):
         '''Get my balance