/azcaptchaapi

python api upload image captcha to azcaptcha.com

Primary LanguagePythonMIT LicenseMIT

AZCaptcha.com Python API

This library implements a simple to use wrapper around the AZCaptcha.com API.

Installation

From PyPi

pip install azcaptchaapi

From source

git clone https://github.com/azcaptcha/azcaptchaapi.git
cd azcaptchaapi
python setup.py install

Examples

Initializing the API

from azcaptcha import AZCaptchaApi
api = AZCaptchaApi('<API KEY>')

Solving a captcha blocking

with open('/my/captcha/path.png', 'rb') as captcha_file:
    captcha = api.solve(captcha_file)

print(captcha.await_result())

Waits until the captcha is either solved or an error occurred (indicated through an exception).

Solve captcha "non-blocking"

captcha = api.solve(captcha_file)
print(captcha.try_get_result())

If already available, prints the captcha text, else None. Please note that while this code doesn't repeatedly ask the API if the captcha was solved, the HTTP request is still sent synchronously, so this method isn't really non-blocking.

Reporting a bad captcha

result = captcha.await_result()
if use_captcha_code(result) == 'failed':
    captcha.report_bad()

Query account balance

print(api.get_balance())

Compatibilty

This library was successfully tested on Python 2.7 and 3.5. Python versions < 2.7 are not officially supported.

License

This code is released under MIT license. Dependencies are under their respective licenses.

This project is not affiliated with, maintained, authorized, endorsed or sponsored by AZCaptcha.com or any of its affiliates.