Каталог API v1

Все маршруты требуют JWT в заголовке Authorization.

Дерево каталога

GET /api/v1/get/catalog

Возвращает полный каталог. Узел содержит UMI object ID, имя и, только если у него есть дети, массив subSections. Сокращенный фрагмент production-дерева:

{
  "status": true,
  "data": [
    {
      "name": "Аксессуары",
      "id": 123743,
      "subSections": [
        {
          "name": "Антенны Wi-Fi и GSM/GPRS/LTE",
          "id": 233805
        },
        {
          "name": "Оборудование Wi-Fi доступа",
          "id": 233806
        },
        {
          "name": "Кабели для мультипортовых плат",
          "id": 233807
        },
        {
          "name": "Монтажные комплекты",
          "id": 233808
        },
        {
          "name": "Оптоволоконные модули bypass",
          "id": 233809
        },
        {
          "name": "Прочие кабели, разъемы и заглушки",
          "id": 233810
        },
        {
          "name": "Корпусы IP67",
          "id": 73531619
        }
      ]
    }
  ],
  "error": {},
  "message": ""
}

У листового узла ключ subSections отсутствует, а не равен пустому массиву.

Производители раздела

GET /api/v1/get/vendors/for/:id

id — UMI object ID раздела. Допускается CSV нескольких ID:

GET /api/v1/get/vendors/for/128491,128492

Ответ — уникальный отсортированный массив исходных названий производителей:

{
  "status": true,
  "data": ["GETAC ", "IEI ", "Panasonic ", "Winmate "],
  "error": {},
  "message": ""
}

Пробельные Unicode-символы в названиях являются частью legacy-значения. Не используйте результат как нормализованный справочник без предварительной обработки на стороне клиента.

Метаданные раздела

GET /api/v1/get/section-meta/:id

Возвращает данные раздела, типы товаров, схему характеристик и фильтры. Можно передать несколько UMI ID через запятую, например /api/v1/get/section-meta/128491,233813. Типы, схемы и значения фильтров объединяются по всем выбранным разделам; общий товар учитывается один раз. В поле section возвращается раздел с минимальным найденным UMI ID. filterValuesSource сохраняет имя индекса этого базового раздела; значения фильтров при этом включают все выбранные разделы. Сокращенный пример показывает точную форму полей production-ответа:

{
  "status": true,
  "data": {
    "section": {
      "id": 128491,
      "hierarchyId": 99961,
      "name": "Защищенные коммуникаторы и промышленные КПК",
      "url": "https://nnz-ipc.ru/catalogue/rugged_mobile_computers/rugged_handheld/"
    },
    "productTypes": [
      {
        "id": 13496,
        "name": "1C: Защищенные коммуникаторы и промышленные КПК",
        "productsCount": 3
      }
    ],
    "featureSchema": {
      "groups": [
        {
          "id": 186052,
          "uid": "cenovye_svojstva",
          "name": "i18n::fields-group-cenovye_svojstva",
          "ord": 20,
          "typeId": 13496,
          "objectTypeName": "1C: Защищенные коммуникаторы и промышленные КПК",
          "fields": [204000, 215484]
        }
      ],
      "fields": {
        "21": {
          "id": 21,
          "uid": "locktime",
          "name": "i18n::field-locktime",
          "groupId": 186056,
          "groupName": "i18n::fields-group-locks",
          "groupOrd": 45,
          "ord": 5,
          "typeId": 13496,
          "objectTypeName": "1C: Защищенные коммуникаторы и промышленные КПК",
          "inFilter": false,
          "inSearch": false,
          "dataType": "date",
          "isMultiple": false,
          "guideId": null,
          "mainFilter": false,
          "hidden": false,
          "baseProperty": false,
          "analog": false
        }
      }
    },
    "filters": [
      {
        "uid": "e15cc30f-e238-11e6-8dc0-00155d0c1500",
        "name": "Диагональ экрана",
        "groupName": "Мобильные компьютеры",
        "groupIds": [213923],
        "fieldIds": [191501],
        "typeIds": [13496],
        "dataType": "relation",
        "isMultiple": false,
        "mainFilter": true,
        "hidden": false,
        "values": []
      }
    ],
    "filterValuesSource": null
  },
  "error": {},
  "message": ""
}

Названия схемы могут содержать исходные значения i18n::...; это часть контракта первой версии.

Для отсутствующего раздела ответ успешный, data содержит {}, а message содержит сообщение «Раздел с id ... не найден в базе данных».