API Яндекс.Чистый Веб

Проверка CAPTCHA

Описание

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

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

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

ПараметрЗначение
key API-ключ.
id Идентификатор сообщения, выданный сервисом при проверке на спам (см. элемент id ответа на запрос проверки спама).
captcha

Идентификатор CAPTCHA.

value

Проверяемое значение 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 введено неправильно, либо производится повторная проверка значения.

Пример

Запрос:

http://cleanweb-api.yandex.ru/1.0/check-captcha?key=cw.1.1.20110707T172051Z.faf547ce44f3d10b.d7e3028845ea04f56c38f7eef90999f765dd0d1f&id=%23%23133396837300000%5B%5D&captcha=308JR213_g_JSaE76RvWQ3R63cK4mc8N&value=3234

Ответ:

<!DOCTYPE check-captcha-result PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<check-captcha-result xmlns:x="http://www.yandex.ru/xscript"><failed></failed></check-captcha-result>