Tencent

Типы задач

• TencentTaskProxyless - мы используем собственный пул прокси-серверов для решения капч
• TencentTask - мы используем переданный вами прокси

Спецификация для типа задачи TencentTaskProxyless

Свойство	Тип	Обязателен	Описание
type	Строка	Да	Тип задачи: TencentTaskProxyless TencentTask
websiteURL	Строка	Да	Полный URL-адрес целевой веб-страницы, на которую загружается капча. Мы не открываем страницу, это не проблема, если страница доступна только для авторизованных пользователей
appId	Строка	Да	Значение параметра appId в исходном коде сайта

Спецификация для типа задачи TencentTask

Задача TencentTask расширяет TencentTaskProxyless, добавляя набор параметров, связанных с прокси, перечисленных ниже.

Свойство	Тип	Обязателен	Описание
proxyType	Строка	Да	Тип прокси: http socks4 socks5
proxyAddress	Строка	Да	IP-адрес прокси-сервера или имя хоста
proxyPort	Число	Да	Порт прокси-сервера
proxyLogin	Строка	Нет	Логин используемый для аунтефикации на прокси-сервере
proxyPassword	Строка	Нет	Пароль используемый для аунтефикации на прокси-сервере

Примеры запросов

Метод: createTask
Эндпоинт API: https://api.rucaptcha.com/createTask

Пример запроса TencentTaskProxyless

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type":"TencentTaskProxyless",
        "appId":"190014885",
        "websiteURL":"https://www.example.com/"
    }
}

Пример запроса TencentTask

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type":"TencentTask",
        "appId":"190014885",
        "websiteURL":"https://www.example.com/",
        "proxyType": "http",
        "proxyAddress": "1.2.3.4",
        "proxyPort": "8080",
        "proxyLogin": "user23",
        "proxyPassword": "p4$w0rd"
    }
}

Пример ответа

Метод: getTaskResult
Эндпоинт API: https://api.rucaptcha.com/getTaskResult

{
    "errorId": 0,
    "status": "ready",
    "solution": {
        "appid": "190014885",
        "ret": 0,
        "ticket": "tr0344YjJASGmJGtohyWS_y6tJKiqVPIdFgl87vWlVaQoueR8D6DH28go-i-VjeassM31SXO7D0*",
        "randstr": "@KVN"
    },
    "cost": "0.00299",
    "ip": "1.2.3.4",
    "createTime": 1692863536,
    "endTime": 1692863556,
    "solveCount": 1
}

Использование токена

Полученный при решении токен передается в callback-функцию, определенную во втором аргументе вызова конструктора TencentCaptcha при инициализации капчи.

new TencentCaptcha(CaptchaAppId, callback, options);

Эта функция обычно используется для выполнения запроса к бекенду сайта и верификации токена. Вы можете либо выполнить callback-функцию, передавая токен в качестве аргумента, либо составить запрос к сайту, подставив в него токен.

Например, если капча инициализурована следующим образом:

const myCallbackFunction = (token) {
    // verify the token
}
var captcha = new TencentCaptcha('190014885', myCallbackFunction, {});
captcha.show(); 

То вам нужно вызвать:

let data = JSON.parse(res)
myCallbackFunction(res.solution)

Где res - это ответ API в формате JSON.