Проверка CAPTCHA

Описание

Для проверки значения CAPTCHA, введенного пользователем, необходимо методом GET обратиться к следующему ресурсу:

http://cleanweb-api.yandex.ru/1.0/check-captcha

Параметры запроса

При повторной проверке с использованием одного и того же идентификатора CAPTCHA всегда будет получен отрицательный результат (вне зависимости от правильности проверяемого значения). Поэтому после каждой проверки следует, при необходимости, запрашивать CAPTCHA заново.

Ответ сервера

В случае правильного ввода CAPTCHA возвращается пакет с XML следующего вида:

<check-captcha-result>
    <ok />
</check-captcha-result>

Если проверяемое значение введено неверно или идентификатор CAPTCHA использован повторно, то возвращается следующий ответ:

<check-captcha-result>
    <failed />
</check-captcha-result>

Элементы XML-схемы ответа:

• check-captcha-result – корневой элемент;
• ok – значение CAPTCHA введено правильно.
• failed – значение CAPTCHA введено неправильно, либо производится повторная проверка значения.