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

Начало

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

Методы

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

Ключи и заголовки

Ключи

КлючГде взятьОграничения
la_live_ + 32 символаКабинет → Сайты: один ключ на сайттолько с IP сервера сайта, только оплаченные базы
la_test_ + 32 символаКабинет → Песочница: один на аккаунтлюбые IP, выдуманные данные, 1 000 запросов в сутки

Ключ показывается один раз при выпуске — мы храним только его хэш. Потеряли ключ — выпустите новый в кабинете, старый сразу перестанет работать.

Ключ — секрет сервера. Не вставляйте его в JavaScript, мобильные приложения и публичные репозитории. Запрос из браузера посетителя не пройдёт проверку IP.

Заголовки запроса

ЗаголовокЗначение
X-Api-Keyобязателенключ сайта или песочницы
X-Visitor-Ipобязателен для методов базIP посетителя вашего сайта, для которого вы делаете запрос (IPv4 или IPv6). Не IP сервера!
X-Visitor-UaжелательноUser-Agent посетителя — помогает точнее отличать ботов
X-Visitor-Passесли естьпропуск капчи посетителя из куки la_pass

Лимиты на посетителя считаются по X-Visitor-Ip. Если подставлять туда IP сервера или один и тот же адрес, все посетители сайта окажутся «одним человеком» и быстро упрутся в лимит.

Сайт за прокси или CDN: берите настоящий IP посетителя из заголовка, который ставит прокси (X-Real-IP, CF-Connecting-IP), а не из REMOTE_ADDR.

IP сервера

Боевой ключ принимает запросы только с IP, указанных в настройках сайта (до двух). С других адресов — ошибка 403 ip_not_allowed. Свой внешний IP можно узнать с сервера:

curl -s https://ifconfig.me

Изменения IP и доменов в кабинете начинают действовать в течение 5 минут.

Ответ

{
  "ok": true,
  "data": [ … ],
  "meta": { "base": "jp", "page": 1, "per_page": 20, "total": 318, "pages": 16, "sort": "date" }
}

Заголовки ответа методов баз: X-RateLimit-Limit, X-RateLimit-Remaining (остаток суточного лимита по продукту), X-RateLimit-Reset (секунд до полуночи МСК).