GeeTest¶

To import this module:

from python_rucaptcha.gee_test import GeeTest

class python_rucaptcha.gee_test.GeeTest(websiteURL: str, method: GeetestEnm | str, gt: str, version: int = 3, initParameters: dict = None, *args, **kwargs)¶

__init__(websiteURL: str, method: GeetestEnm | str, gt: str, version: int = 3, initParameters: dict = None, *args, **kwargs)¶

The class is used to work with GeeTest.

Parameters:

rucaptcha_key – User API key
websiteURL (str) – Full URL of the captcha page
gt (str) – The value of the gt parameter found on the site
version (int) – GeeTest V4 captcha should be set to 4.
initParameters (dict) – Required for GeeTest V4. The parameter that is passed in the initGeetest4 function call must contain the captcha_id value. Example of usage: { “captcha_id” : “e392e1d7fd421dc63325744d5a2b9c73”}
method (GeetestEnm | str) – Captcha type
kwargs – Not required params for task creation request

Examples

>>> import requests
>>> resp_data = requests.get("https://www.geetest.com/demo/gt/register-enFullpage-official").json()
>>> print(resp_data)
{
    'success': 1,
    'challenge': '1ad03db8aff920037fb8117827eab171',
    'gt': '022397c99c9f646f6477822485f30404',
    'new_captcha': True
}
>>> GeeTest(rucaptcha_key="aa9011f31111181111168611f1151122",
...             gt=resp_data["gt"],
...             websiteURL="https://www.geetest.com/en/demo",
...             method=GeetestEnm.GeeTestTaskProxyless.value
...             ).captcha_handler(challenge=resp_data["challenge"])
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "captcha_id":"e392e1d7fd421dc63325744d5a2b9c73",
      "lot_number":"e6c3bed2854f41f880662c48afff5dcb",
      "pass_token":"fad5eb52fc83bf7617402fcccfb211a21e0aa1d1044",
      "gen_time":"1693924478",
      "captcha_output":"fN36ufW6cQN4SQ-JRDQC70nSq9UcQBg=="
   },
   "cost":"0.00299",
   "ip":"1.2.3.4",
   "createTime":1692863536,
   "endTime":1692863556,
   "solveCount":1,
   "taskId":75190409731
}

>>> await GeeTest(rucaptcha_key="aa9011f31111181111168611f1151122",
...             gt=resp_data["gt"],
...             websiteURL="https://www.geetest.com/en/demo",
...             method=GeetestEnm.GeeTestTaskProxyless.value
...             ).aio_captcha_handler(challenge=resp_data["challenge"])
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "captcha_id":"e392e1d7fd421dc63325744d5a2b9c73",
      "lot_number":"e6c3bed2854f41f880662c48afff5dcb",
      "pass_token":"fad5eb52fc83bf7617402fcccfb211a21e0aa1d1044",
      "gen_time":"1693924478",
      "captcha_output":"fN36ufW6cQN4SQ-JRDQC70nSq9UcQBg=="
   },
   "cost":"0.00299",
   "ip":"1.2.3.4",
   "createTime":1692863536,
   "endTime":1692863556,
   "solveCount":1,
   "taskId":75190409731
}

>>> GeeTest(rucaptcha_key="aa9011f31111181111168611f1151122",
...             websiteURL="https://rucaptcha.com/demo/geetest-v4",
...             method=GeetestEnm.GeeTestTaskProxyless.value,
...             version=4,
...             initParameters={"captcha_id": "e392e1d7fd421dc63325744d5a2b9c73"},
...             ).captcha_handler(challenge=resp_data["challenge"])
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "captcha_id":"e392e1d7fd421dc63325744d5a2b9c73",
      "lot_number":"e6c3bed2854f41f880662c48afff5dcb",
      "pass_token":"fad5eb52fc83bf7617402fcccfb211a21e0aa1d1044",
      "gen_time":"1693924478",
      "captcha_output":"fN36ufW6cQN4SQ-JRDQC70nSq9UcQBg=="
   },
   "cost":"0.00299",
   "ip":"1.2.3.4",
   "createTime":1692863536,
   "endTime":1692863556,
   "solveCount":1,
   "taskId":75190409731
}

>>> await GeeTest(rucaptcha_key="aa9011f31111181111168611f1151122",
...             websiteURL="https://rucaptcha.com/demo/geetest-v4",
...             method=GeetestEnm.GeeTestTaskProxyless.value,
...             version=4,
...             initParameters={"captcha_id": "e392e1d7fd421dc63325744d5a2b9c73"},
...             ).aio_captcha_handler(challenge=resp_data["challenge"])
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "captcha_id":"e392e1d7fd421dc63325744d5a2b9c73",
      "lot_number":"e6c3bed2854f41f880662c48afff5dcb",
      "pass_token":"fad5eb52fc83bf7617402fcccfb211a21e0aa1d1044",
      "gen_time":"1693924478",
      "captcha_output":"fN36ufW6cQN4SQ-JRDQC70nSq9UcQBg=="
   },
   "cost":"0.00299",
   "ip":"1.2.3.4",
   "createTime":1692863536,
   "endTime":1692863556,
   "solveCount":1,
   "taskId":75190409731
}

>>> GeeTest(rucaptcha_key="aa9011f31111181111168611f1151122",
...             gt=resp_data["gt"],
...             websiteURL="https://www.geetest.com/en/demo",
...             method=GeetestEnm.GeeTestTaskProxyless.value,
...             userAgent="Some specific user agent",
...             proxyType="socks5",
...             proxyAddress="0.0.0.0",
...             proxyPort=443,
...             ).captcha_handler(challenge=resp_data["challenge"])
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "captcha_id":"e392e1d7fd421dc63325744d5a2b9c73",
      "lot_number":"e6c3bed2854f41f880662c48afff5dcb",
      "pass_token":"fad5eb52fc83bf7617402fcccfb211a21e0aa1d1044",
      "gen_time":"1693924478",
      "captcha_output":"fN36ufW6cQN4SQ-JRDQC70nSq9UcQBg=="
   },
   "cost":"0.00299",
   "ip":"1.2.3.4",
   "createTime":1692863536,
   "endTime":1692863556,
   "solveCount":1,
   "taskId":75190409731
}

Returns:: Dict with full server response

Notes

https://rucaptcha.com/api-docs/geetest

captcha_handler(challenge: str, **kwargs) → dict¶

Sync solving method

Parameters:

challenge (str) – The value of the challenge parameter found on the site
kwargs – Parameters for the requests library

Returns:

Dict with full server response

Return type:

dict

Notes

Check class docstirng for more info

async aio_captcha_handler(challenge: str) → dict¶

Async solving method

Parameters:: challenge (str) – The value of the challenge parameter found on the site
Returns:: Dict with full server response
Return type:: dict

Notes

Check class docstirng for more info

GeeTest¶

Contents

Navigation