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

Начало

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

Методы

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

Документация LotAvto API

LotAvto API отдаёт лоты аукционов Японии (текущие и итоги торгов), объявления Кореи и Китая (che168, dongchedi) в одном формате JSON. API рассчитан на запросы с сервера вашего сайта: ключ нельзя использовать в браузере.

Быстрый старт

  1. Зарегистрируйтесь — ключ песочницы la_test_… выдаётся сразу. Песочница принимает запросы с любых IP и возвращает выдуманные данные в боевом формате.
  2. Сделайте первый запрос:
curl "https://api.lotavto.ru/v1/jp/makes" \
  -H "X-Api-Key: la_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Visitor-Ip: 203.0.113.7"
  1. Подключите SDK для PHP или пишите запросы сами — см. примеры.
  2. В кабинете добавьте сайт и IP сервера — получите боевой ключ la_live_…. Оплатите нужные базы.
  3. Замените ключ в настройках сайта. Больше ничего менять не нужно.

Основное

Адрес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курсы ЦБ РФ

Как это выглядит на живом сайте — демо-сайт.