РУКОВОДСТВО ПО ИНТЕГРАЦИИ

Проверьте транспортные средства со своего сервера.

Аутентификация

Создайте учетную запись и скопируйте свой пароль из «Моей учетной записи». Использовать Authorization: Bearer TU_CLAVE или заголовок X-API-Key. Не помещайте ключи в URL-адреса, общедоступный HTML или JavaScript браузера.

curl "https://TU_DOMINIO/api/search.php?brand=Abarth&model=124&y1=2018&y2=2018&limit=10" \
  -H "Authorization: Bearer TU_CLAVE"

Фильтры и нумерация страниц

Параметр	Использование
brand / brand_id	Точная марка или идентификатор.
model / model_id	Часть имени или идентификатора.
cc, kw, cv	Точные числовые значения.
y1, y2	Перекрытие с интервалом лет. Для определенного года используйте оба значения с одинаковым значением.
limit	От 1 до 100; по умолчанию 50.
offset	От 0. Используйте next_offset, пока has_more имеет значение true.

{
  "results": [
    {"id": 1, "brand": "Abarth", "model": "124 Spider",
     "cc": 1368, "kw": 125, "cv": 170, "engine_code": "552 53 268",
     "year_start": 2018, "year_end": 2019, "fuel": null, "body": null}
  ],
  "count": 1, "limit": 10, "offset": 0,
  "has_more": false, "next_offset": null, "tokens_remaining": 99
}

Наглядный пример формата. Конкретные результаты зависят от каталога.

Фильтры обновлённого каталога

generation, fuel, technology, engine: Точные текстовые значения.

fuel=Diésel&technology=TDI&engine=BKD

Баланс и лимиты

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

Сначала расходуются текущие ежемесячные запросы к базе данных, а затем дополнительные купленные. Пополнения сохраняются при продлении месяца. Бесплатные планы продлеваются при использовании или через cron; Тарифные планы пополняются только после подтвержденного платежа. Если период истечет, ваш ежемесячный баланс больше не будет доступен.

HTTP	Значение
400	Неверные фильтры или диапазон лет.
401	Ключ API отсутствует.
402	Нет доступных запросов к базе данных.
403	Неактивный ключ или подписка без доступа.
429	Лимит в минуту; Повторить-через: 60.
500 / 503	Ошибка сервиса или подключения.

Объем данных

Нулевой конечный год означает, что конечный год неизвестен и при фильтрации рассматривается как открытый диапазон. Это не доказывает, что модель все еще производится. Инвертированные диапазоны исключены до рассмотрения. Топливо, тело и другие поля могут не сообщаться. Эти данные не гарантируют совместимость запчасти: это соотношение должно быть предоставлено и подтверждено магазином.