Accuracy Feedback

Report createTask Accuracy

To ensure accurate task handling, users can submit feedback on solved tasks. This helps refine performance and improve response accuracy.

POST https://feedback.captchasonic.com/reportAccuracy

Host:

api.captchasonic.com

Content-Type:

application/json

Parameters

Parameter	Type	Description
`apiKey`	`string`	Your API authentication key.
`data`	`string[]`	List of encoded task data extracted from the task response (`meta.data`).
`pass`	`boolean`	`true` if the task was successfully solved, `false` if it failed.

Payload Request body

{
    "apiKey": "sonic_ce3e47d1e142578fc60743ee2180da6f",
    "data": [
      "5C8o1JEsKAW0bIBDuxmJiy..."
    ],
    "pass": false
}

We need to extract the meta.data from the response body to complete a feedback request.

For Extracting the meta.data Get to the ImageTask and select the desired CAPTCHA type. This will allow you to generate the appropriate payload based on the selected CAPTCHA.

How to Proceed

Navigate to ImageTask or click on the aboveImageTask to get redirected to the page.
Choose the CAPTCHA type (e.g., Bls-Ocr/reCaptcha).
Follow the instructions to generate the task payload.
For further details on payload structure, refer to the ImageTask section.

Response Example

{
    "code": 200,
    "msg": "",
    "answers": [
        [
            {
                "x": 399,
                "y": 170
            }
        ]
    ],
    "meta": {
        "pass_report": true,
        "fail_report": true,
        "data": "5C8o1JEsKAW0bIBDuxmJiy..."
    }
}

Understanding the Response

Field	Description
`code: 200`	The request was successfully processed.
`msg`	An optional message field, typically empty when the request succeeds.
`answers`	Contains an array of coordinates (`x`, `y`) representing the solution to the task.
`meta.pass_report`	`true` if the task passed verification.
`meta.fail_report`	`true` if the task failed verification.
`meta.data`	An encrypted string containing task-related metadata, which can be used for accuracy reporting.

Extracting `meta.data` from the `Response`

Once a task is processed, it generates the following response:

{
    "code": 200,
    "msg": "",
    "answers": [
        [
            {
                "x": 399,
                "y": 170
            }
        ]
    ],
    "meta": {
        "pass_report": true,
        "fail_report": true,
        "data": "5C8o1JEsKAW0bIBDuxmJiy..."
    }
}

Now, we can create a feedback request using `"data": "5C8o1JEsKAW0bIBDuxmJiy..."`.

Expected API Response

{
    "code": 200,
    "msg": "Accuracy report submitted successfully."
}

This metadata helps track accuracy, refine task performance, and enhance system reliability.