Sales Ninja — документация

# Управление smart-фидами

Smart-фид — описание источника товарного фида и стратегии его пересчёта/выгрузки. CRUD позволяет программно создавать фиды, менять источник и параметры пересчёта.

Доступ к содержимому фида (списку товаров, категориям, атрибутам, лог-операциям, ручному реимпорту, копированию, выгрузке) намеренно не вынесен в Public API — управляйте этим через админку Sales Ninja.

База: https://api.sales-ninja.me/public/api/v1/manage/smart-feeds

HTTP Что делает
GET / Список фидов.
POST /list Список со сложным фильтром.
GET /{id} Полная сущность.
POST / Создать.
PUT /{id} Обновить.
DELETE /{id} Удалить.

# Тело

{
  "name": "Основной товарный фид",
  "sourceType": "Url",
  "sourceUrl": "https://example.com/feed.yml",
  "sourceFormat": "YandexMarketYml",
  "processingStrategy": "Standard",
  "popularityIndexDefault": 0.5,
  "optimizationMetric": "ConversionCount",
  "conversionAttributionType": "AllConversions",
  "popularitySliceStrategy": "TopByIndex",
  "popularityIndexThreshold": 0.7,
  "modeledConversionId": null,
  "parentFeedId": null,
  "recalculationScheduleType": "Daily",
  "recalculationWindowStartHourUtc": 3,
  "state": "Active",
  "exportFormat": "YandexMarketYml",
  "goals": [
    { "goalId": "299837db-9b51-45a4-996b-844d3fd05bbd", "weight": 1.0 }
  ]
}

# Поля

Поле Описание
name Название фида в админке.
sourceType Откуда взять данные: Url, Upload, …
sourceUrl URL источника (если sourceType=Url).
sourceFormat Формат исходного фида (YandexMarketYml, Csv, …).
processingStrategy Стратегия обработки данных.
optimizationMetric По какой метрике рассчитывается популярность товаров.
conversionAttributionType Атрибуция конверсий на товары.
popularitySliceStrategy Стратегия отбора «топовых» товаров (TopByIndex, Threshold, …).
popularityIndexDefault Стартовое значение индекса для новых товаров (0…1).
popularityIndexThreshold Порог для Threshold-стратегии.
modeledConversionId Если оптимизируем по моделируемой конверсии.
parentFeedId Если фид — дочерний (отфильтрованная проекция родителя).
recalculationScheduleType Daily, Hourly, Manual, …
recalculationWindowStartHourUtc Час старта окна пересчёта (0…23) в UTC.
state Active / Paused / Archived (специфичные для фидов значения).
exportFormat Формат экспортного фида, если он включён.
goals[] Цели, по которым считается популярность. weight — вес цели в формуле.

Точные допустимые значения enum’ов лучше узнавать из админки или из ответа GET /{id} уже существующего фида — полный список зависит от конфигурации проекта и эволюционирует.

# Ответ

{
  "feedId": "8f3a1e4b-…",
  "createdFeed": true
}

← Управление опросами →