How to report bad tokens

Why 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:

https://api.capmonster.cloud/reportIncorrectImageCaptcha - for Image Captcha reports

https://api.capmonster.cloud/reportIncorrectTokenCaptcha - for token Captcha reports: recaptcha(2,3, enterprise), hcaptcha, geetest, turnstile.
Also supported:
https://api.capmonster.cloud/reportIncorrectRecaptcha, https://api.capmonster.cloud/reportIncorrectHcaptcha - works the same as reportIncorrectTokenCaptcha

 

Request format: JSON POST

Request parameters

Parameter

Type

Required

Value

Parameter

Type

Required

Value

clientKey

String

Yes

Your unique account key

taskId

Integer

Yes

Task ID

Request example:

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

 

Response structure:

Property

Type

Meaning

Property

Type

Meaning

errorId

Integer

Error ID.
0 - no errors, no errorCode property
1 - error, information about it is in the errorCode property

errorCode

String

Error code. See error types.

status

String

success - the report is accepted.
If the report is not accepted, then the field is missing, the reason is in the errorCode

Response example

{ "errorId": 0, "status": "success" }
{ "errorId": 1, "errorCode": "ERROR_KEY_DOES_NOT_EXIST" }