Меню документації

reportCorrectRecaptcha: повідомити про правильно вирішені токени Recaptcha

Використовуйте цей метод разом із reportIncorrectRecaptcha для своїх Recaptcha V3 та Recaptcha V2 Enterprise завдань. Наразі звіти для Recaptcha V2 приймаються, але з часом ігноруються. Наша якість V2 становить близько 99%, і вам не потрібно складати білий список успішних працівників.

За лаштунками ми помістимо працівника, про якого ви повідомили, до білого списку, і на наступному етапі призначення працівників для розв'язання ваших капч наша система зіставить цей білий список з вашими капчами. Якщо хтось із працівників, про яких ви повідомили, перебуває в режимі онлайн і не працює, він або вона будуть поставлені в першу чергу, щоб прийняти до виконання ваше нове завдання. Система збереже цей запис протягом наступної години і може видалити його, якщо ви надішлете запит reportIncorrectRecaptcha для завдання, яке виконує той самий працівник із білого списку.
Коротше кажучи, reportCorrectRecaptcha додає працівників до вашого білого списку, reportIncorrectRecaptcha видаляє їх звідти.

Повідомлення про правильно вирішені токени працюватиме на помітних обсягах, починаючи з 10 завдань на хвилину. Це пов’язано з великою міграцією наших працівників між різними чергами завдань та їх поточним статусом зайнятості/простою. При таких обсягах, як 1 завдання на хвилину, ви не помітите жодного покращення якості.

Звіти потрібно надсилати протягом 60 секунд після завершення завдання. Якщо ви надішлете звіт пізніше, API поверне помилку ERROR_NO_SUCH_CAPCHA_ID. Дозволяється надсилати лише один звіт на кожне завдання.

Адреса: https://api.anti-captcha.com/reportCorrectRecaptcha
Метод: POST
Content-type: application-json

Параметри запиту

Властивість Тип Обов’язково Призначення
clientKey Рядок Так
taskId Цілочисельний Так

Приклад запиту

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "taskId":12345
}' https://api.anti-captcha.com/reportCorrectRecaptcha
        


Структура відповіді

Властивість Тип Призначення
errorId Цілочисельний Ідентифікатор помилки.
0 - без помилок, операція завершена успішно.
>1 - ідентифікатор помилки. Код помилки та короткий опис передано у властивостях errorCode та errorDescription.
errorCode Рядок
errorDescription Рядок Короткий опис помилки
status Рядок
Результат операції. Ви отримаєте або код помилки, або status="success", коли скарга буде прийнята.

Приклад відповіді

JSON без помилок
          {
    "errorId":0,
    "status":"success"
}
        
JSON з помилкою
          {
    "errorId": 16,
    "errorCode": "ERROR_NO_SUCH_CAPCHA_ID",
    "errorDescription": "Task you are requesting does not exist in your current task list or has been expired."
}