Page Comparison

...

Параметр

Тип

Обязательный

Значение

type

String

да

GeeTestTaskProxyless

websiteURL

String

да

Адрес страницы на которой решается каптча

gt

String

да

Ключ-идентификатор GeeTest для домена. Статическое значение, редко обновляется.

challenge

String

да

Меняющийся ключ.
При каждом обращении к нашему API нужно получать новое значение ключа. Если каптча загружена на странице, то значение challenge уже недействительно и Вы получите в ответ ошибку ERROR_TOKEN_EXPIRED.

Warning
За задачи с ошибкой `ERROR_TOKEN_EXPIRED` плата взимается как за успешно решённые задачи.

Нужно изучить запросы и найти тот, в котором возвращается это значение и перед каждым созданием задачи на распознавания выполнять этот запрос и парсить challenge из него.

geetestApiServerSubdomain

String

нет

Необязательный параметр.
Может потребоваться для некоторых сайтов.

geetestGetLib

String

нет

Необязательный параметр. Может потребоваться для некоторых сайтов.
Отправляйте JSON в виде строки.

version

Integer

нет

Номер версии (по умолчанию равен 3). Возможные значения: 3, 4.

initParameters

Object

нет

Дополнительные параметры для 4 версии.

userAgent

String

нет

User-Agent браузера, используемый для решения каптчи.

GeeTest V3

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

Адрес https://api.capmonster.cloud/createTask

Code Block

{
    "clientKey":"YOUR_CAPMONSTER_CLOUD_API_KEY",
    "task":
    {
        "type":"GeeTestTaskProxyless",
        "websiteURL":"https://example.com/geetest.php",
        "gt":"81dc9bdb52d04dc20036dbd8313ed055",
        "challenge":"d93591bdf7860e1e4ee2fca799911215"
    }
}

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

Code Block
{ "errorId":0, "taskId":407533072 }

Получение результата

Используйте метод getTaskResult чтобы получить решение GeeTest. В зависимости от загрузки системы вы получите ответ через время в диапазоне от 10 с до 30 с.

Свойство	Тип	Описание
challenge	Строка	Все три параметра необходимы при отправке формы на целевом сайте.
validate	Строка
seccode	Строка

Пример:

Code Block
{ "errorId":0, "status":"ready", "solution": { "challenge":"0f759dd1ea6c4wc76cedc2991039ca4f23", "validate":"6275e26419211d1f526e674d97110e15", "seccode":"510cd9735583edcb158601067195a5eb\|jordan" } }

GeeTest V4

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

Адрес https://api.capmonster.cloud/createTask

Code Block

{
    "typeclientKey":"GeeTestTaskProxyless",YOUR_CAPMONSTER_CLOUD_API_KEY",
    "task":
    {
        "type":"GeeTestTaskProxyless",
        "websiteURL":"https://example.com/geetest.php",
        "gt":"81dc9bdb52d04dc20036dbd8313ed055",
        "gtversion":"81dc9bdb52d04dc20036dbd8313ed055",
  4,
        "initParameters": {
          "challengeriskType": "d93591bdf7860e1e4ee2fca799911215slide"
        }
    }
}

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

Code Block
{ "errorId":0, "taskId":407533072 }

Получение результата

Используйте метод getTaskResult чтобы получить решение GeeTest. В зависимости от загрузки системы вы получите ответ через время в диапазоне от 10 с до 30 с.

Свойство

Тип

Описание

challenge

captcha_id

Строка

Все

три параметры

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

validate


	lot_number	Строка
	pass_token	Строка
	gen_time	Строка

seccode

captcha_output

Строка

Пример:

Code Block

{
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "captcha_id":"f5c2ad5a8a3cf37192d8b9c039950f79",
        "challengelot_number":"bcb2c6ce2f8e4e9da74f2c1fa63bd713",
        "pass_token":"0f759dd1ea6c4wc76cedc2991039ca4f23edc7a17716535a5ae624ef4707cb6e7e478dc557608b068d202682c8297695cf",
        "validategen_time":"6275e26419211d1f526e674d97110e151683794919",
        "seccodecaptcha_output":"510cd9735583edcb158601067195a5eb|jordanXwmTZEJCJEnRIJBlvtEAZ662T...[cut]...SQ3fX-MyoYOVDMDXWSRQig56"
    }
}

Versions Compared

Old Version 8

New Version Current

Key

GeeTest V3

Получение результата

GeeTest V4

Получение результата