Для партнёров и платформ

API каталога Irkeda

Публичный каталог позволяет регулярно получать опубликованные товары Irkeda: название, описания, состав, галерею, характеристики, цену и статус наличия. Регистрация и API-ключ для чтения не требуются.

Форматы

Снимок каталога

/api/catalog/v1/snapshot

Список товаров

/api/catalog/v1/products?limit=100&locale=ru-RU

Изменения после синхронизации

/api/catalog/v1/changes?since={changes_cursor}

OpenAPI 3.1

/api/catalog/v1/openapi.json

JSON Schema товара

/api/catalog/v1/schemas/catalog-item.schema.json

YML для партнёров

/feeds/catalog.yml

Google Merchant XML

/feeds/google-merchant.xml

Как синхронизировать

  1. Получите текущий /snapshot и сохраните snapshot_id и changes_cursor.
  2. Читайте /products, передавая возвращённый next_cursor без изменений, пока has_more=false.
  3. Обновляйте цену и наличие не реже одного раза в 15 минут. Количественный остаток API намеренно не раскрывает.
  4. Для последующих обновлений читайте /changes. При ответе 410 выполните новый полный снимок.
curl 'https://irkeda.ru/api/catalog/v1/products?limit=100&locale=ru-RU'

Гарантии контракта

  • Одна запись соответствует одному SKU; варианты связывает стабильный group_id.
  • В API нет закупочных цен, внутренних ID, секретов и точного количества на складе.
  • JSON, YML, Google-фид и разметка карточки строятся из одной товарной модели.
  • Неизвестные GTIN, аллергены и другие сведения возвращаются как null, а не придумываются.

Открытая лицензия и условия использования каталога

Редакция от 11 октября 2026 года

1. Лицензиар и принятие условий

Лицензиар — Общество с ограниченной ответственностью «Фабрика здоровой еды» (ИНН 3849055580, КПП 380801001, ОГРН 1153850044281; 664003, г. Иркутск, ул. Тимирязева, д. 5 «Б»). Интернет-магазин Irkeda используется Лицензиаром для публикации каталога.

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

2. Материалы каталога

Условия распространяются на опубликованные через API товарные описания, фотографии, изображения, характеристики и подборку материалов каталога, права на которые принадлежат Лицензиару либо могут предоставляться им третьим лицам. Цена, наличие и иные фактические сведения должны использоваться только в актуальном виде, полученном из API.

3. Предоставляемые права

Лицензиар безвозмездно предоставляет простую (неисключительную) лицензию на территории всего мира сроком на пять лет с момента принятия условий. Продолжение использования после этого срока означает принятие действующей на тот момент редакции лицензии.

В пределах лицензии разрешается:

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

4. Обязанности пользователя

  • указывать производителя «Фабрика здоровой еды» и, где это технически возможно, источник со ссылкой на соответствующую карточку товара на irkeda.ru;
  • не выдавать материалы за сведения о другом товаре, производителе или продавце;
  • обновлять цену и наличие не реже одного раза в 15 минут;
  • прекратить показ снятого товара и удалить его материалы не позднее 24 часов после получения события удаления;
  • соблюдать применимые требования к рекламе, защите потребителей и достоверности информации о товаре.

5. Что не разрешено

Без отдельного письменного согласия Лицензиара запрещается:

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

6. Доступ к API

API предоставляется только для чтения. Нельзя обходить ограничения нагрузки, получать внутренние данные, вмешиваться в работу сайта или создавать чрезмерную нагрузку. Лицензиар вправе временно ограничить вредоносный или чрезмерный трафик.

7. Актуальность и ответственность

Каталог предоставляется в актуальном на момент ответа API виде. Цена и наличие могут изменяться. При оформлении заказа действуют сведения, показанные покупателю на irkeda.ru в момент заказа. Лицензиар не отвечает за изменения материалов пользователем, несвоевременную синхронизацию или временную недоступность API, кроме случаев, когда ответственность нельзя исключить или ограничить по закону.

8. Прекращение и изменение условий

При нарушении условий право использования соответствующих материалов прекращается, а пользователь обязан удалить их в течение 24 часов после уведомления. Лицензиар может публиковать новую редакцию условий для последующего использования и новых выгрузок. Законно полученные ранее права не ограничиваются задним числом, кроме случаев нарушения условий либо необходимости соблюсти права третьих лиц или требования закона.

9. Применимое право и связь

К условиям применяется право Российской Федерации. До обращения в суд стороны стараются урегулировать спор претензией в течение 30 календарных дней. Обращения по вопросам использования каталога принимаются по адресу shop@irkeda.ru.