getToken: get token directly
WARNING
Get task directly for solving selected captcha type.
Specify which type of captchas in the parameter.
Currently supports the following types:
-
ReCaptchaV2Task
-
ReCaptchaV2EnterpriseTask
-
ReCaptchaV2TaskProxyLess
-
ReCaptchaV2EnterpriseTaskProxyLess
-
ReCaptchaV3Task
-
ReCaptchaV3EnterpriseTask
-
ReCaptchaV3TaskProxyLess
-
ReCaptchaV3EnterpriseTaskProxyLess
Example request
POST https://api.capsolver.com/getToken
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey":"YOUR_API_KEY",
"appId": "APP_ID",
"task": {
"type":"ReCaptchaV3TaskProxyLess",// Write below the type you need to identify
"websiteURL": "https://demo.com/",
"websiteKey": "6LcpsXsnAAAAAbbAcafeiCCr3xxx2UeZ8qef1Hbb"
}
}Request Parameters
| Parameters | Type | Required | Description |
|---|---|---|---|
| clientKey | String | Yes | Client account key, can be found in dashboard |
| appId | String | No | Your Developer appId, Apply in dashboard’s developer section |
| task | Object | Yes | Task object |
| callbackUrl | String | No | token will send (post) to this endpoint |
Example response
{
"errorId": 0,
"taskId": "...",
"solution": {
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
},
"status": "ready"
}Response Structure
| Parameters | Type | Description |
|---|---|---|
| errorId | Integer | Error message: 0 - no error 1 - with error |
| errorCode | String | errorCode: full list of errors |
| errorDescription | String | Error Description |
| status | String | • ready |
| solution | Object | Task result data. Different for each type of task |
Response specification
-
Recognition success: When
errorId=0andstatus=ready, the result is insolution. -
Error: When
errorIdis greater than0, please know the error information according toerrorDescription.