Add Tencent method

Author: dzmitry-duboyski

README.md

@@ -41,6 +41,7 @@ Examples of API requests for different captcha types are available on the [JavaS
     - [Rotate](#rotate)
     - [KeyCaptcha](#keycaptcha)
     - [Cutcaptcha](#cutcaptcha)
+    - [Tencent](#tencent)
   - [Other methods](#other-methods)
     - [goodReport](#goodreport)
     - [badReport](#badreport)
@@ -605,6 +606,25 @@ console.log(err);
 })
 ```
 
+### Tencent
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#tencent)</sup>
+
+Use this method to solve Tencent captcha. Returns the response in JSON.
+
+```js
+solver.tencent({
+    pageurl: "https://mysite.com/page/with/tencent",
+    appId: "189956587"  
+})
+.then((res) => {
+console.log(res);
+})
+.catch((err) => {
+console.log(err);
+})
+```
+
 ## Other methods
 
 ### goodReport

examples/tencent.js

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

src/structs/2captcha.ts

@@ -274,6 +274,14 @@ export interface paramsKeyCaptcha {
     proxytype?: string
 }
 
+export interface paramsTencent {
+    pageurl: string,
+    appId: string,
+    pingback?: string,
+    proxy?: string,
+    proxytype?: string
+}
+
 /**
  * An object containing properties of the captcha solution.
  * @typedef {Object} CaptchaAnswer
@@ -1712,6 +1720,66 @@ public async keyCaptcha(params: paramsKeyCaptcha): Promise<CaptchaAnswer> {
     }
 }
 
+/**
+* ### Solves a Tencent.
+* 
+* Use this method to solve Tencent captcha. Returns a token.
+* [Read more about Tencent](https://2captcha.com/2captcha-api#tencent).
+* 
+* @param {{ pageurl, appId, pingback, proxy, proxytype }} params Parameters for solving Tencent 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.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.tencent({
+*   pageurl: "https://mysite.com/page/with/tencent",
+*   appId: "189956587"
+* })
+* .then((res) => {
+*     console.log(res);
+* })
+* .catch((err) => {
+*     console.log(err);
+* })
+*/
+public async tencent(params: paramsTencent): Promise<CaptchaAnswer> {
+    params = await renameParams(params)
+    checkCaptchaParams(params, "tencent")
+
+    const payload = {
+        ...params,
+        method: "tencent",
+        ...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']
+"turnstile", "base64", "capy","datadome", "cybersiara", "mt_captcha", "bounding_box", 'friendly_captcha', 'grid', 'textcaptcha', 'canvas', 'rotatecaptcha', 'keycaptcha', 'cutcaptcha', 'tencent']
 
 // Names of required fields that must be contained in the parameters captcha
 const recaptchaRequiredFields =   ['pageurl','googlekey']
@@ -26,6 +26,7 @@ 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'] 
 
 /**
  * Getting required arguments for a captcha.
@@ -103,6 +104,9 @@ const getRequiredFildsArr = (method: string):Array<string> => {
     case "cutcaptcha":
       requiredFieldsArr = cutcaptchaRequiredFields
       break;
+    case "tencent":
+      requiredFieldsArr = tencentRequiredFields
+      break;
   }
   return requiredFieldsArr
 }

src/utils/renameParams.ts

@@ -33,6 +33,9 @@ export default function renameParams(params: any) {
     // Cutcaptcha
     "miseryKey":"misery_key",
     "apiKey":"api_key",
+
+    // Tencent
+    "appId": "app_id",
   }
 
   for(let key in params) {