Skip to main content

How to report bad tokens

Why to report?

We need reports so that we automatically analize data on the quality of token issued by our API. Reports are processed automatically, and the team takes actions to improve the quality of the tokens, whether it is updating the system for new tasks, improving grids, etc.


Method addresses:

For token-captcha reports: recaptcha(2,3, enterprise), hcaptcha, geetest, funcaptcha, turnstile.

Request format: JSON POST

Request parameters

ParameterTypeRequiredValue
clientKeyStringYesYour unique account key
taskIdIntegerYesTask ID

Request example:

{

"clientKey":"67b6bcbb1a728ea8d563de6d169a2057",
"taskId": 7654321

}

Response structure:

PropertyTypeValue
errorIdIntegerError ID.
0 - no errors, no errorCode property;
1 - error, information about it is in the errorCode property.
errorCodeStringError code. Check out error types.
statusStringsuccess - the report is accepted.
If the report is not accepted, then the field is missing, the reason is in the errorCode

Response example

Response WITHOUT error

{
"errorId": 0,
"status": "success"
}

Response WITH an error

{
"errorId": 1,
"errorCode": "ERROR_KEY_DOES_NOT_EXIST"
}