Капча посетителя
Когда один посетитель делает слишком много запросов, API отвечает 428 captcha_required. Вместо блокировки посетитель проходит невидимую проверку: браузер несколько секунд решает вычислительную задачу (proof-of-work), никаких картинок. Пропуск действует 2 часа и привязан к IP посетителя.
Схема
- Ваш сервер получил
428— покажите посетителю страницу с виджетом. - Виджет получает задачу
GET https://api.lotavto.ru/captcha/challenge, решает её в фоне (Web Worker) и отправляетPOST /captcha/verify. - Пропуск сохраняется в куку
la_passвашего домена. - Сервер передаёт его в следующих запросах в заголовке
X-Visitor-Pass.
Виджет
Без внешних зависимостей, подключается одной строкой:
<script src="https://api.lotavto.ru/captcha.js" async></script>
<div class="lotavto-captcha" data-cookie="la_pass" data-reload="1"></div>| Атрибут | Описание |
|---|---|
data-cookie | имя куки, куда положить пропуск на 2 часа |
data-reload | 1 — перезагрузить страницу после проверки |
data-input | имя скрытого поля формы для пропуска (если проверка — часть формы) |
data-callback | имя глобальной функции, которая получит пропуск |
data-auto | 0 — начинать проверку по кнопке |
Программно: LotAvtoCaptcha.solve().then(function (pass) { … }). На блоке виджета срабатывает событие lotavto:pass.
На сервере
<?php
$headers = array(
'X-Api-Key: ' . LOTAVTO_KEY,
'X-Visitor-Ip: ' . $_SERVER['REMOTE_ADDR'],
);
if (!empty($_COOKIE['la_pass'])) {
$headers[] = 'X-Visitor-Pass: ' . $_COOKIE['la_pass'];
}
// … запрос к API …
if ($httpCode == 428) {
http_response_code(429);
echo '<script src="https://api.lotavto.ru/captcha.js" async></script>';
echo '<p>Проверяем браузер, это займёт несколько секунд…</p>';
echo '<div class="lotavto-captcha" data-cookie="la_pass" data-reload="1"></div>';
exit;
}В SDK всё это уже есть: $api->isCaptchaRequired() и $api->captchaHtml(), пропуск из куки la_pass подставляется автоматически.