2026-04-11 10:43:53

Классификатор программ для электронных вычислительных машин и баз данных

Поиск по коду

Метод: GET
Эндпоинт: /api/classifier/v1/software/{code}

Где {code} — код классификатора программного обеспечения.

Поддерживаемые форматы кода

• 01 — раздел (chapter)
• 01.02 — тип (type)

Точку можно опускать и передавать код числом:

• 1 — раздел (chapter)
• 102 — тип (type)

Максимальная глубина: 2 уровня (раздел → тип).

Примеры успешных запросов

Раздел (chapter):

GET /api/classifier/v1/software/01

Ответ:

{
  "chapter": {
    "id": "01",
    "name": "Встроенное программное обеспечение"
  }
}

Тип (type):

GET /api/classifier/v1/software/01.02

Ответ:

{
  "type": {
    "chapter_id": "01",
    "id": "01.02",
    "name": "Встроенные системные программы - операционные системы",
    "description": "Встроенные системные управляющие программы, которые должны храниться в постоянной памяти и обеспечивать управление вычислительными ресурсами устройств..."
  },
  "chapter": {
    "name": "Встроенное программное обеспечение",
    "id": "01"
  }
}

Ошибки при поиске по коду

Код ответа	Сообщение	Причина
400	“не указан код классификатора или поисковый запрос”	Пустой запрос
400	“раздел и тип должны состоять из двух цифр”	Неправильное количество цифр в сегменте (например, 102 вместо 01.02 или 10000)
400	“код классификатора должен состоять максимум из 2 элементов, разделенных точкой”	Более двух уровней (например, 01.02.03.04)

---

Поиск по тексту (названию или описанию)

Метод: GET
Эндпоинт: /api/classifier/v1/software/?query={search}

Параметры: - query — поисковый запрос (строка)

Минимальная длина запроса: 4 символа

Пример успешного поиска

GET /api/classifier/v1/software/?query=виртуал

Ответ (массив объектов):

[
  {
    "type": {
      "id": "02.04",
      "name": "Средства виртуализации",
      "description": "Программы, которые должны обеспечивать доступ к общему пулу конфигурируемых вычислительных ресурсов...",
      "chapter_id": "02"
    },
    "chapter": {
      "id": "02",
      "name": "Системное программное обеспечение"
    }
  },
  {
    "type": { ... },
    "chapter": { ... }
  }
  // ... другие совпадения
]

Пример пустого результата

При запросе, по которому ничего не найдено, возвращается пустой объект:

{}

Ошибки поиска по тексту

Код ответа	Сообщение	Причина
400	“не указан код классификатора или поисковый запрос”	Запрос без параметра query
400	“поисковый запрос должен содержать не менее 4 символов”	Длина запроса меньше 4 символов (например, дл)

---

Структура ответа

• По коду:

  • При запросе раздела (01) возвращается только chapter.
  • При запросе типа (01.02) возвращаются type + chapter.

• По тексту:

  • Возвращается массив объектов.
  • Каждый объект содержит type (с полями id, name, description, chapter_id) и chapter.

Поля объекта type: - id — код типа (например, 01.02) - name — наименование - description — подробное описание (может быть длинным) - chapter_id — код раздела

Поля объекта chapter: - id — код раздела - name — наименование раздела

---