Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Current »

This type of task is for solving GeeTest. This task will be performed by our service using our own proxy servers.
Your application should send the site address, public domain key (gt), key (challenge).

The result of solving the task is three tokens for submitting the form.

Object structure

The gt, challenge and geetestApiServerSubdomain parameters are most often found inside the initGeetest JavaScript function.

Parameter

Type

Required

Value

type

String

yes

GeeTestTaskProxyless

websiteURL

String

yes

Address of the page on which the captcha is recognized

gt

String

yes

The GeeTest identifier key for the domain. Static value, rarely updated.

challenge

String

yes

A dynamic key.
Each time our API is called, we need to get a new key value. If the captcha is loaded on the page, then the challenge value is no longer valid and you will get ERROR_TOKEN_EXPIRED error.

You will be charged for tasks with ERROR_TOKEN_EXPIRED error!

It is necessary to examine the requests and find the one in which this value is returned and, before each creation of the recognition task, execute this request and parse the challenge from it.

geetestApiServerSubdomain

String

no

Optional parameter. May be required for some sites.

geetestGetLib

String

no

Optional parameter. May be required for some sites.
Send JSON as a string.

userAgent

String

no

Browser User-Agent used to recognize captcha.

Request example

Address: https://api.capmonster.cloud/createTask

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

Response example

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

Getting the result

Use the getTaskResult method to get the result of GeeTest recognition. Depending on the system load, you will receive a response after a time in the range from 10 s to 30 s.

Property

Type

Description

challenge

String

All three parameters are required when submitting the form on the target site.

validate

String

seccode

String

Example:

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

  • No labels