Feedback Accuracy | CaptchaSonic Docs

Отчёт о точности createTask

Чтобы обеспечить корректную обработку задач, пользователи могут отправлять обратную связь по решённым задачам. Это помогает повысить производительность и точность ответов.

POST https://feedback.captchasonic.com/reportAccuracy
Host: feedback.captchasonic.com
Content-Type: application/json

Параметры

Параметр	Тип	Описание
`apiKey`	`string`	Ключ аутентификации API.
`data`	`string[]`	Список закодированных данных задач, извлечённых из ответа (`meta.data`).
`pass`	`boolean`	`true`, если задача решена успешно, `false` — в случае ошибки.

Тело запроса

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

Чтобы отправить отзыв, необходимо извлечь meta.data из тела ответа.

Для извлечения meta.data перейдите в раздел ImageTask и выберите нужный тип CAPTCHA. Это позволит сформировать соответствующий запрос для выбранной CAPTCHA.

Порядок действий

Перейдите в ImageTask или нажмите на ссылку ImageTask выше.
Выберите тип CAPTCHA (например, Bls-Ocr/reCaptcha).
Следуйте инструкциям для формирования запроса.
Подробности по структуре запроса см. в разделе ImageTask.

Пример ответа

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

Разбор ответа

Поле	Описание
`code: 200`	Запрос обработан успешно.
`msg`	Необязательное текстовое поле; обычно пустое при успешном запросе.
`answers`	Массив координат (`x`, `y`), представляющий решение задачи.
`meta.pass_report`	`true`, если задача прошла проверку.
`meta.fail_report`	`true`, если задача не прошла проверку.
`meta.data`	Зашифрованная строка с метаданными задачи; используется для отчётов о точности.

Извлечение `meta.data` из `Response`

После обработки задачи формируется следующий ответ:

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

Теперь можно отправить запрос обратной связи, используя `"data": "5C8o1JEsKAW0bIBDuxmJiy..."`.

Ожидаемый ответ API

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

Эти метаданные помогают отслеживать точность, оптимизировать производительность и повышать надёжность системы.