SDK для PHP
Один файл lotavto_client.php, класс LotavtoClient. Работает на PHP от 5.3 до 8.6, без composer и зависимостей: через curl, а без него — через file_get_contents.
Что умеет
- Подставляет заголовки: ключ, 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}/makes | 10 мин |
models($base, $make) | /v1/{base}/models | 10 мин |
filters($base, $params) | /v1/{base}/filters | 10 мин |
lots($base, $params) | /v1/{base}/lots | — |
lot($base, $id) | /v1/{base}/lots/{id} | — |
rates() | /v1/rates | 10 мин |
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.