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

Начало

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

Методы

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 Примеры

SDK для PHP

Один файл lotavto_client.php, класс LotavtoClient. Работает на PHP от 5.3 до 8.6, без composer и зависимостей: через curl, а без него — через file_get_contents.

Скачать lotavto_client.php

Что умеет

  • Подставляет заголовки: ключ, IP и User-Agent посетителя, пропуск капчи из куки la_pass.
  • Кэширует справочники в файлах на 10 минут.
  • Показывает капчу посетителю при 428 — одним вызовом.
  • Возвращает data ответа или false с подробностями ошибки.

Пример

<?php
require __DIR__ . '/lotavto_client.php';

$api = new LotavtoClient('la_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', array(
    'cacheDir' => __DIR__ . '/cache',   // кэш справочников; false — выключить
    'timeout'  => 10,
));

$lots = $api->lots('jp', array('make' => 'toyota', 'model' => 'prius', 'year_from' => 2018, 'per_page' => 20));
if ($lots === false) {
    if ($api->isCaptchaRequired()) {
        echo $api->captchaHtml();          // проверка браузера, затем страница перезагрузится
        exit;
    }
    $e = $api->lastError();               // array('code' => …, 'message' => …, 'http' => …)
    error_log('LotAvto: ' . $e['code'] . ' ' . $e['message']);
    $lots = array();
}
$meta = $api->lastMeta();                 // page, per_page, total, pages…
foreach ($lots as $lot) {
    echo $lot['make'], ' ', $lot['model'], ' ', $lot['year'], ' — ', $lot['price'], ' ', $lot['currency'], "\n";
}

Методы

МетодAPIКэш
me()/v1/me—
makes($base)/v1/{base}/makes10 мин
models($base, $make)/v1/{base}/models10 мин
filters($base, $params)/v1/{base}/filters10 мин
lots($base, $params)/v1/{base}/lots—
lot($base, $id)/v1/{base}/lots/{id}—
rates()/v1/rates10 мин
setVisitor($ip, $ua, $pass)задать посетителя явно (по умолчанию — из $_SERVER и куки)
lastError(), lastMeta()ошибка и meta последнего запроса
isCaptchaRequired(), captchaHtml()обработка 428 captcha_required

Опции конструктора

timeout, connectTimeoutтаймауты, сек (10 и 5)
cacheDir, cacheTtlпапка и время жизни кэша справочников (по умолчанию — системная временная папка, 600 с)
visitorIpHeaderоткуда брать IP посетителя за прокси/CDN: HTTP_X_REAL_IP, HTTP_CF_CONNECTING_IP…
baseUrlадрес API (по умолчанию https://api.lotavto.ru)
useCurlпринудительно включить/выключить curl

Дополнительные коды ошибок SDK: network — нет связи с API, bad_response — ответ не JSON.