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

Получение CAPTCHA

Описание

Чтобы получить CAPTCHA, необходимо методом GET обратиться к ресурсу:

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

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

Набор символов в капче и язык логотипа. Возможные значения:

  • std — цифры, русскоязычный логотип;
  • estd — цифры, англоязычный логотип;
  • lite — простые для чтения цифры, русскоязычный логотип;
  • elite — простые для чтения цифры, англоязычный логотип;
  • rus — русские буквы, русскоязычный логотип;
  • latl — латинские строчные буквы , русскоязычный логотип;
  • elatl — латинские строчные буквы, англоязычный логотип;
  • latu — латинские прописные буквы, русскоязычный логотип;
  • elatu — латинские прописные буквы, англоязычный логотип;
  • latm — латинские буквы смешанного регистра, русскоязычный логотип;
  • elatm — латинские буквы смешанного регистра, англоязычный логотип.

По умолчанию type=std.

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

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

<get-captcha-result>
    <captcha>abcd12345</captcha>
    <url>http://i.captcha.yandex.net/image?key=abcd12345</url> 
</get-captcha-result>

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

  • get-captcha-result – корневой элемент;
  • captcha – идентификатор CAPTCHA для проверки введенного пользователем значения;
  • url – URL изображения CAPTCHA, показываемого пользователю (200 x 60 пикселов).

Пример

Запрос:

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

Ответ:

<!DOCTYPE get-captcha-result PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<get-captcha-result xmlns:x="http://www.yandex.ru/xscript"><captcha>308JR213_g_JSaE76RvWQ3R63cK4mc8N</captcha><url>http://u.captcha.yandex.net/image?key=308JR213_g_JSaE76RvWQ3R63cK4mc8N</url></get-captcha-result>

Примеры капча

TypeВид капчи
std (цифры, русскоязычный логотип)
lite (простые для чтения цифры, русскоязычный логотип)
rus (русские буквы, русскоязычный логотип)
elatm (латинские буквы смешанного регистра, англоязычный логотип)