Документация LotAvto API
LotAvto API отдаёт лоты аукционов Японии (текущие и итоги торгов), объявления Кореи и Китая (che168, dongchedi) в одном формате JSON. API рассчитан на запросы с сервера вашего сайта: ключ нельзя использовать в браузере.
Быстрый старт
- Зарегистрируйтесь — ключ песочницы
la_test_…выдаётся сразу. Песочница принимает запросы с любых IP и возвращает выдуманные данные в боевом формате. - Сделайте первый запрос:
curl "https://api.lotavto.ru/v1/jp/makes" \
-H "X-Api-Key: la_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "X-Visitor-Ip: 203.0.113.7"- Подключите SDK для PHP или пишите запросы сами — см. примеры.
- В кабинете добавьте сайт и IP сервера — получите боевой ключ
la_live_…. Оплатите нужные базы. - Замените ключ в настройках сайта. Больше ничего менять не нужно.
Основное
| Адрес | https://api.lotavto.ru/v1/…, только HTTPS, только GET |
| Ключ | заголовок X-Api-Key — подробнее |
| IP посетителя | заголовок X-Visitor-Ip — обязателен для запросов к базам |
| Формат ответа | JSON, UTF-8: {"ok":true,"data":…,"meta":{…}} или {"ok":false,"error":{"code":"…","message":"…"}} |
| Базы | jp, jpstat, kr, che168, dongchedi — поля |
| Лимиты | 10 000 запросов в сутки на базу, ограничения на посетителя — подробнее |
Методы
| Метод | Что возвращает |
|---|---|
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 | курсы ЦБ РФ |
Как это выглядит на живом сайте — демо-сайт.