Разделы документации

Начало

Быстрый старт Ключи и заголовки Базы и поля

Методы

GET /v1/me GET /v1/{base}/makes GET /v1/{base}/models GET /v1/{base}/filters GET /v1/{base}/lots GET /v1/{base}/lots/{id} GET /v1/rates

Правила

Ошибки Лимиты Капча посетителя Фото и Referer

Инструменты

Песочница SDK для PHP Примеры

Капча посетителя

Когда один посетитель делает слишком много запросов, API отвечает 428 captcha_required. Вместо блокировки посетитель проходит невидимую проверку: браузер несколько секунд решает вычислительную задачу (proof-of-work), никаких картинок. Пропуск действует 2 часа и привязан к IP посетителя.

Схема

  1. Ваш сервер получил 428 — покажите посетителю страницу с виджетом.
  2. Виджет получает задачу GET https://api.lotavto.ru/captcha/challenge, решает её в фоне (Web Worker) и отправляет POST /captcha/verify.
  3. Пропуск сохраняется в куку la_pass вашего домена.
  4. Сервер передаёт его в следующих запросах в заголовке 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-reload1 — перезагрузить страницу после проверки
data-inputимя скрытого поля формы для пропуска (если проверка — часть формы)
data-callbackимя глобальной функции, которая получит пропуск
data-auto0 — начинать проверку по кнопке

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