API для партнёров lrk-parts.ru

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

1. Получите токен доступа у менеджера lrk-parts.ru.
2. Проверьте доступ — запрос вернёт название вашей компании и лимиты:
   Копировать

   curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
        https://lrk-parts.ru/api/v1/limits

3. Найдите деталь по артикулу или названию:
   Копировать

   curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
        "https://lrk-parts.ru/api/v1/parts/search?q=21214-3502010"

4. Для обновления всего ассортимента используйте полную выгрузку.

2Авторизация

Каждый запрос передаётся с заголовком:

Authorization: Bearer ВАШ_ТОКЕН

• Токен выдаёт и отзывает администратор lrk-parts.ru. Храните его как пароль — не публикуйте в коде страниц сайта.
• Нет токена или он неверный — ответ 401; доступ приостановлен — 403.
• Ответы — JSON в кодировке UTF-8.

3Методы

Параметры, примеры ответов и форма для пробных запросов — в справочнике методов.

4Данные позиции

Пример

{
  "sku": "21214-3502010",
  "name": "Барабан тормозной задний",
  "brand": "ОАТ",
  "price": 2205.0,
  "retail_price": 2450.0,
  "currency": "RUB",
  "quantity": 14,
  "quantity_exact": true,
  "availability": "in_stock",
  "availability_label": "В наличии",
  "url": "https://lrk-parts.ru/catalog/oat/baraban-tormoznoy-zadniy-21214-3502010",
  "analogs": []
}

5Цены и остатки

Цена

price — цена для вашей компании по назначенной группе цен (опт, дилер…). Если для позиции отдельная цена группы не задана — базовая цена. retail_price — розничная цена сайта для сравнения. Цены в рублях с копейками.

Остаток

Режим показа остатков для вашей компании виден в /limits, поле quantity_mode:

6Аналоги

У каждой позиции — массив analogs: заданные аналоги и кроссы. Тип связи relation_type: analog — аналог, oem — номер производителя техники, original — оригинал.

• in_catalog: true — аналог есть в доступном вам каталоге, у него заполнены цена и остаток (те же поля, что у позиции).
• in_catalog: false — известен только артикул и тип связи, остальные поля null.
• Аналоги не нужны — передайте analogs=0: ответ станет меньше и быстрее (особенно для выгрузки).

7Доступный каталог

Вам может быть открыт не весь каталог, а отдельные категории. Позиции вне них не находятся поиском, по артикулу возвращают 404, не попадают в выгрузку, а аналоги из них приходят с in_catalog: false.

Сколько позиций доступно — /limits → catalog.positions (столько же придёт в полной выгрузке); catalog.categories: all — весь каталог, restricted — отдельные категории.

8Полная выгрузка

Для синхронизации всего ассортимента — /api/v1/export. Страницы листаются курсором: позиции не теряются и не дублируются, даже если каталог меняется во время выгрузки.

1. Первый запрос — без after.
2. Следующие — с after = meta.next_after из предыдущего ответа.
3. meta.has_more = false — выгрузка закончена. Позиции, которых в ней нет, сняты с продажи или недоступны.

# Пример на bash + jq: выгрузка страницами по 2000 позиций без аналогов
AFTER=""
while : ; do
  RESP=$(curl -s -H "Authorization: Bearer ВАШ_ТОКЕН" \
    "https://lrk-parts.ru/api/v1/export?per_page=2000&analogs=0${AFTER:+&after=$AFTER}")
  echo "$RESP" | jq -c '.data[]' >> catalog.jsonl
  [ "$(echo "$RESP" | jq -r '.meta.has_more')" = "true" ] || break
  AFTER=$(echo "$RESP" | jq -r '.meta.next_after')
  sleep 1   # не больше 60 запросов в минуту
done

Рекомендуем обновлять каталог не чаще раза в час, а между выгрузками пользоваться /parts/{артикул} для отдельных позиций.

9Лимиты запросов

• Лимит выгрузки — 24 полных проходов каталога в сутки страницами по 500 позиций (не меньше 200); растёт вместе с каталогом. Страницами по 2000 на проход нужно вчетверо меньше запросов.
• Суточные счётчики обнуляются в 00:00 (по московскому времени). Ваши точные лимиты и расход — /limits.
• В каждом ответе — заголовки X-Daily-Limit, X-Daily-Remaining, X-Daily-Reset (суточный лимит) и X-RateLimit-Limit, X-RateLimit-Remaining (минутный).
• При превышении — 429: минутного — повторите через Retry-After секунд; суточного — код daily_limit_exceeded и время сброса.
• Индивидуальные лимиты для крупных партнёров — по запросу менеджеру.

10Ошибки

Формат ответа об ошибке:

{
  "error": {
    "code": "validation_failed",
    "message": "Количество символов в поле q должно быть не меньше 2.",
    "fields": { "q": ["Количество символов в поле q должно быть не меньше 2."] }
  }
}

11История версий

Изменения обратно совместимы: поля не удаляются и не меняют смысл, только добавляются новые.