imagetyperz-api-client

imagetyperz-api-client - Imagetyperz API wrapper
=========================================

ImagetyperzAPI (client) is a super easy to use bypass captcha API wrapper for imagetyperz.com captcha service

Installation

npm install imagetyperz-api-client

or

git clone https://github.com/imagetyperz-api/imagetyperz-api-javascript

How to use?

ImagetyperzAPI (client) uses promise handling

Simply require the module, set the auth details and start using the captcha service:

``javascript




`
Set access_token for authentication

`javascript
// get access token from: http://www.imagetyperz.com/Forms/ClientHome.aspx
imagetyperzapi.set_access_key('YOUR_ACCESS_KEY');
`
Once you've set your authentication details, you can start using the API

Get balance

`javascript
const balance = await imagetyperzapi
console.log('Balance:', balance)
`


Solving

`javascript
var captcha_params = {}
// captcha_params.iscase = 'true'; // case sensitive captcha
// captcha_params.isphrase = 'true'; // text contains at least one space (phrase)
// captcha_params.ismath = 'true'; // instructs worker that a math captcha has to be solved
// captcha_params.alphanumeric = '2'; // 1 - digits only, 2 - letters only
// captcha_params.minlength = 2; // captcha text length (minimum)
// captcha_params.maxlength = 6; // captcha text length (maximum)
const b64captcha = '/9j/4AAQJRgABAQA...' // captcha image encoded as b64
const captcha_id = await imagetyperzapi.submit_image(b64captcha, captcha_params)
`
ID is used to retrieve solution when solved.

Observation
It works with URL instead b64 image too

$3

For recaptcha submission there are two things that are required.
- page_url (required)
- site_key (required)
- type (optional, defaults to 1 if not given)
- 1 - v2
- 2 - invisible
- 3 - v3
- 4 - enterprise v2
- 5 - enterprise v3
- domain - used in loading of reCAPTCHA interface, default: www.google.com (alternative: recaptcha.net) - optional
- v3_min_score - minimum score to target for v3 recaptcha - optional
- v3_action - action parameter to use for v3 recaptcha - optional
- proxy - proxy to use when solving recaptcha, eg. 12.34.56.78:1234 or 12.34.56.78:1234:user:password - optional
- user_agent - useragent to use when solve recaptcha - optional
- data-s - extra parameter used in solving recaptcha - optional
- cookie_input - cookies used in solving reCAPTCHA - - optional

`javascript
var captcha_params = {}
captcha_params.page_url = 'https://your-site.com'
captcha_params.sitekey = '7LrGJmcUABBAALFtIb_FxC0LXm_GwOLyJAfbbUCL'
// captcha_params.type = 1; // optional, defaults to 1
// captcha_params.domain = 'www.google.com' // used in loading reCAPTCHA interface, default: www.google.com (alternative: recaptcha.net) - optional
// captcha_params.v3_min_score = 0.3; // min score to target when solving v3 - optional
// captcha_params.v3_action = 'homepage'; // action to use when solving v3 - optional
// captcha_params.proxy = '126.45.34.53:123'; // optional
// captcha_params.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/60.0'; // optional
// captcha_params.data_s = 'recaptcha data-s value' // optional
// captcha_params.cookie_input = 'a=b;c=d' // optional
const captchaID = await imagetyperzapi.submit_recaptcha(captcha_params)
`
ID will be used to retrieve the g-response, once workers have
completed the captcha. This takes somewhere between 10-80 seconds.

Check Retrieve response

$3

GeeTest is a captcha that requires 3 parameters to be solved:
- domain
- challenge
- gt
- api_server (optional)

The response of this captcha after completion are 3 codes:
- challenge
- validate
- seccode

Important
This captcha requires a unique challenge to be sent along with each captcha.

`javascript
var captcha_params = {}
captcha_params.domain = 'https://your-site.com'
captcha_params.challenge = 'eea8d7d1bd1a933d72a9eda8af6d15d3'
captcha_params.gt = '1a761081b1114c388092c8e2fd7f58bc'
// captcha_params.api_server = 'api.geetest.com' // geetest domain - optional
// captcha_params.proxy = '126.45.34.53:123'; // optional
// captcha_params.user_agent = 'Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/60.0'; // optional
const captchaID = await imagetyperzapi.submit_geetest(captcha_params)
`

Optionally, you can send proxy and user_agent along.

$3

GeeTesV4 is a new version of captcha from geetest that requires 2 parameters to be solved:

- domain
- geetestid (captchaID) - gather this from HTML source of page with captcha, inside the