Add atbCaptcha method

Author: dzmitry-duboyski

README.md

@@ -42,6 +42,7 @@ Examples of API requests for different captcha types are available on the [JavaS
     - [KeyCaptcha](#keycaptcha)
     - [Cutcaptcha](#cutcaptcha)
     - [Tencent](#tencent)
+    - [atbCAPTCHA](#atbcaptcha)
   - [Other methods](#other-methods)
     - [goodReport](#goodreport)
     - [badReport](#badreport)
@@ -625,6 +626,26 @@ console.log(err);
 })
 ```
 
+### atbCAPTCHA
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#atb-captcha)</sup>
+
+Use this method to solve atbCAPTCHA challenge. Returns a token to bypass the captcha.
+
+```js
+solver.atbCaptcha({
+    pageurl: "https://mysite.com/page/with/atbCAPTCHA",
+    appId: "af25e409b33d722a95e56a230ff8771c",
+    apiServer: "https://cap.aisecurius.com"
+})
+.then((res) => {
+console.log(res);
+})
+.catch((err) => {
+console.log(err);
+})
+```
+
 ## Other methods
 
 ### goodReport

examples/atbcaptcha.js

@@ -0,0 +1,16 @@
+const TwoCaptcha = require("../dist/index.js");
+require('dotenv').config();
+const APIKEY = process.env.APIKEY
+const solver = new TwoCaptcha.Solver(APIKEY);
+
+solver.atbCaptcha({
+    pageurl: "https://mysite.com/page/with/atbCAPTCHA",
+    appId: "af25e409b33d722a95e56a230ff8771c",
+    apiServer: "https://cap.aisecurius.com"
+})
+.then((res) => {
+    console.log(res);
+})
+.catch((err) => {
+    console.log(err);
+})

src/structs/2captcha.ts

@@ -282,6 +282,15 @@ export interface paramsTencent {
     proxytype?: string
 }
 
+export interface paramsAtbCaptcha{
+    pageurl: string,
+    appId: string,
+    apiServer: string,
+    pingback?: string,
+    proxy?: string,
+    proxytype?: string
+}
+
 /**
  * An object containing properties of the captcha solution.
  * @typedef {Object} CaptchaAnswer
@@ -1780,6 +1789,68 @@ public async tencent(params: paramsTencent): Promise<CaptchaAnswer> {
     }
 }
 
+/**
+* ### Solves a atbCAPTCHA.
+* 
+* Use this method to solve atbCAPTCHA captcha. Returns a token.
+* [Read more about atbCAPTCHA](https://2captcha.com/2captcha-api#atb-captcha).
+* 
+* @param {{ pageurl, appId, apiServer, pingback, proxy, proxytype }} params Parameters for solving atbCAPTCHA as an object.
+* @param {string} params.pageurl The URL where the captcha is located.
+* @param {string} params.appId 	The value of `appId` parameter in the website source code.
+* @param {string} params.apiServer The value of `apiServer` parameter in the website source code.
+* @param {string} [params.pingback] Optional param. URL for pingback (callback) response when captcha is solved.
+* @param {string} [params.proxy] Optional param. Proxy to use while solving the captcha. Format: `login:password@123.123.123.123:3128`.
+* @param {string} [params.proxytype] Optional param. Type of your proxy: `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`.
+* 
+* @returns {Promise<CaptchaAnswer>} The result from the solve.
+* @throws APIError
+* 
+* @example
+* solver.atbCaptcha({
+*   pageurl: "https://mysite.com/page/with/tencent",
+*   appId: "af25e409b33d722a95e56a230ff8771c",
+    apiServer: "https://cap.aisecurius.com"
+* })
+* .then((res) => {
+*     console.log(res);
+* })
+* .catch((err) => {
+*     console.log(err);
+* })
+*/
+public async atbCaptcha(params: paramsAtbCaptcha): Promise<CaptchaAnswer> {
+    params = await renameParams(params)
+    checkCaptchaParams(params, "atb_captcha")
+
+    const payload = {
+        ...params,
+        method: "atb_captcha",
+        ...this.defaultPayload,
+    }
+
+    const URL = this.in
+    const response = await fetch(URL, {
+        body: JSON.stringify(payload),
+        method: "post",
+        headers: {'Content-Type': 'application/json'}
+    })
+    const result = await response.text()
+
+    let data;
+    try {
+        data = JSON.parse(result)
+    } catch {
+        throw new APIError(result)
+    }
+
+    if (data.status == 1) {
+        return this.pollResponse(data.request)
+    } else {
+        throw new APIError(data.request)
+    }
+}
+
     /**
      * Reports a captcha as correctly solved.
      * 

src/utils/checkCaptchaParams.ts

@@ -1,6 +1,6 @@
 // Captcha methods for which parameter checking is available
 const supportedMethods = ["userrecaptcha", "hcaptcha", "geetest", "geetest_v4","yandex","funcaptcha","lemin","amazon_waf",
-"turnstile", "base64", "capy","datadome", "cybersiara", "mt_captcha", "bounding_box", 'friendly_captcha', 'grid', 'textcaptcha', 'canvas', 'rotatecaptcha', 'keycaptcha', 'cutcaptcha', 'tencent']
+"turnstile", "base64", "capy","datadome", "cybersiara", "mt_captcha", "bounding_box", 'friendly_captcha', 'grid', 'textcaptcha', 'canvas', 'rotatecaptcha', 'keycaptcha', 'cutcaptcha', 'tencent', 'atb_captcha']
 
 // Names of required fields that must be contained in the parameters captcha
 const recaptchaRequiredFields =   ['pageurl','googlekey']
@@ -26,7 +26,8 @@ const canvasRequiredFields =      ['body'] // and textinstructions or imginstruc
 const rotateRequiredFields =      ['body'] 
 const keycaptchaRequiredFields =  ['pageurl', 's_s_c_user_id', 's_s_c_session_id', 's_s_c_web_server_sign', 's_s_c_web_server_sign2'] 
 const cutcaptchaRequiredFields =  ['pageurl', 'misery_key', 'api_key'] 
-const tencentRequiredFields =     ['pageurl', 'app_id'] 
+const tencentRequiredFields =     ['pageurl', 'app_id']
+const atbCaptchaRequiredFields =  ['pageurl', 'app_id', 'api_server']
 
 /**
  * Getting required arguments for a captcha.
@@ -107,6 +108,9 @@ const getRequiredFildsArr = (method: string):Array<string> => {
     case "tencent":
       requiredFieldsArr = tencentRequiredFields
       break;
+    case "atb_captcha":
+      requiredFieldsArr = atbCaptchaRequiredFields
+      break;
   }
   return requiredFieldsArr
 }

src/utils/renameParams.ts

@@ -36,6 +36,9 @@ export default function renameParams(params: any) {
 
     // Tencent
     "appId": "app_id",
+
+    // atbCAPTCHA
+    "apiServer": "api_server",
   }
 
   for(let key in params) {