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 -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 - помилок немає, операція завершена успішно. >0 - ідентифікатор помилки. Код помилки та його короткий опис доступні у властивостях errorCode і errorDescription. |
errorCode | Рядок | |
errorDescription | Рядок | Короткий опис помилки |
status | Рядок | Результат операції. Ви отримуєте або код помилки, або status="success", якщо скаргу прийнято. |
Приклад відповіді
JSON без помилок
JSON з помилкою
{
"errorId":0,
"status":"success"
}