Уведомление об использовании файлов cookie

Этот сайт использует cookie. Файлы cookie запоминают вас, поэтому мы можем предоставить вам персонализированные услуги. Подробнее.

Looking for international version of our service? Go to 2captcha.com

Запустили сервис для обхода Cutcaptcha: Примеры работы с API

Cutcaptcha recognition and bypass service

Сервис ruCaptcha разработал решение и запустил услугу автоматического обхода капчи Cutcaptcha.

Статья описывает процесс взаимодействия с API.

Cutcaptcha

Что такое Cutcaptcha? Cutcaptcha - это капча, которая представляет собой пазл. Чтобы решить её, пользователю нужно собрать пазл, выбрав правильный элемент из списка. Cutcaptcha используется на файлообменниках, таких как Filecrypt, и выводится в программах скачивания, таких как JDownloader.

JDownloader - это программа для скачивания файлов с открытым исходным кодом, которая призвана сделать процесс загрузки простым и удобным.

Капча может затруднить или даже сделать невозможным скачивание файлов. Но есть просто решение проблемы.

Автоматическое решение Cutcaptcha

Cutcaptcha создана с целью повышения устойчивости к обходу ботами. Но процесс обхода капчи можно автоматизировать.

Сервис 2Captcha позволяет автоматизировать процесс обхода. Сначала надо зарегистрироваться на сайте и получить ключ API.

Затем для решения Cutcaptcha нужно использовать метод на основе токенов. Полное описанный метода - далее.

API

Cutcaptcha

Основанный на токенах метод обхода Cutcaptcha.

Полученный токен необходимо установить в качестве атрибута value для элемента input#cap_token и/или передать функции обратного вызова.

Типы задач

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

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

Свойство Тип Обязателен Описание
type Строка Да Тип задачи:
CutCaptchaTaskProxyless
CutCaptchaTask
websiteURL Строка Да Полный URL-адрес целевой веб-страницы, на которую загружается капча. Мы не открываем страницу, это не проблема, если страница доступна только для авторизованных пользователей
miseryKey Строка Да Значение перемернной CUTCAPTCHA_MISERY_KEY, определенной на странице
apiKey Строка Да Значение аттрибута data-apikey тега body внутри iframe капчи. Также, имя javascript-файла, подключаемого на странице

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

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

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

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

Метод: createTask
Конечная точка API: https://{{api_hostname}}/createTask

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

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "CutCaptchaTaskProxyless",
        "miseryKey": "a1488b66da00bf332a1488993a5443c79047e752",
        "apiKey": "SAb83IIB",
        "websiteURL": "https://example.cc/foo/bar.html"
    }
}

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

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "CutCaptchaTask",
        "miseryKey": "a1488b66da00bf332a1488993a5443c79047e752",
        "apiKey": "SAb83IIB",
        "websiteURL": "https://example.cc/foo/bar.html",
        "proxyType": "http",
        "proxyAddress": "1.2.3.4",
        "proxyPort": "8080",
        "proxyLogin": "user23",
        "proxyPassword": "p4$$w0rd"
    }
}

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

{
    "errorId": 0,
    "status": "ready",
    "solution": {
        "token": "BazM23cpFUUyAAAdqPwNEDZx0REtH3ss"
    },
    "cost": "0.00299",
    "ip": "1.2.3.4",
    "createTime": 1692863536,
    "endTime": 1692863556,
    "solveCount": 1
}

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

Полученный токен поместите в значение тега input с id = cap_token, затем отправьте форму, внутри которой находится этот input, например:

document.querySelector('input#cap_token').value='BazM23cpFUUyAAAdqPwNEDZx0REtH3ss'
document.querySelector('form').submit()

Если на странице задана коллбек-функция, то можно отправить токен через нее:

capResponseCallback('BazM23cpFUUyAAAdqPwNEDZx0REtH3ss')

Обработка ошибок

Если решение капчи не завершено, должен вернуться ответ CAPCHA_NOT_READY.

Если отправка файла завершилась ошибкой, должен вернуться ответ с ошибкой. Перечень всех ошибок с описанием собран в списке.

Цены

Стоимость решения капчи Cutcaptcha — за 160 ₽ 1000 успешно решенных капч.

Полезные материалы

Подробное описание по обходу капчи опубликовано на странице API.

Дополнительная информация по работе с сервисом для заказчиков доступна на странице FAQ.

Примеры кода для работы с сервисом на официальной странице в GitHub.

Отвечаем на вопросы

Если после прочтения документации у вас остались вопросы по новому API, будем рады ответить и помочь:

Можно задать вопрос любым способом:

Мы ценим отзывы и хотим убедиться, что сервис идеально подходит для ваших задач.