Turnstile¶

To import this module:

from python_rucaptcha.turnstile import Turnstile

class python_rucaptcha.turnstile.Turnstile(websiteURL: str, websiteKey: str, userAgent: str, method: str | TurnstileCaptchaEnm = TurnstileCaptchaEnm.TurnstileTaskProxyless, *args, **kwargs)¶

__init__(websiteURL: str, websiteKey: str, userAgent: str, method: str | TurnstileCaptchaEnm = TurnstileCaptchaEnm.TurnstileTaskProxyless, *args, **kwargs)¶

The class is used to work with Cloudflare Turnstile.

Parameters:

rucaptcha_key – User API key
websiteURL (str) – Full URL of the captcha page
websiteKey (str) – The value of the sitekey parameter found on the site
userAgent (str) – Your browser UserAgent
method (str | TurnstileCaptchaEnm) – Captcha type
kwargs – Not required params for task creation request

Examples

>>> Turnstile(rucaptcha_key="aa9011f31111181111168611f1151122",
...             websiteURL="https://www.geetest.com/en/demo",
...             websiteKey="0x4AAAAAAAC3DHQFLr1GavRN",
...             method=TurnstileCaptchaEnm.TurnstileTaskProxyless.value,
...             ).captcha_handler()
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "token":"0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p.d62306d4ee00c77dda697f959ebbd7bd97",
      "userAgent":"Mozilla/5.0 (....."
   },
   "cost":"0.00145",
   "ip":"1.2.3.4",
   "createTime":1692863536,
   "endTime":1692863556,
   "solveCount":1,
   "taskId": 73243152973,
}

>>> await Turnstile(rucaptcha_key="aa9011f31111181111168611f1151122",
...             websiteURL="https://www.geetest.com/en/demo",
...             websiteKey="0x4AAAAAAAC3DHQFLr1GavRN",
...             method=TurnstileCaptchaEnm.TurnstileTaskProxyless.value,
...             ).aio_captcha_handler()
{
   "errorId":0,
   "status":"ready",
   "solution":{
      "token":"0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p.d62306d4ee00c77dda697f959ebbd7bd97",
      "userAgent":"Mozilla/5.0 (....."
   },
   "cost":"0.00145",
   "ip":"1.2.3.4",
   "createTime":1692863536,
   "endTime":1692863556,
   "solveCount":1,
   "taskId": 73243152973,
}

Returns:: Dict with full server response

Notes

https://rucaptcha.com/api-docs/cloudflare-turnstile

captcha_handler(**kwargs) → dict¶

Sync solving method

Parameters:: 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() → dict¶

Async solving method

Returns:: Dict with full server response
Return type:: dict

Notes

Check class docstirng for more info

Turnstile¶

Contents

Navigation