2026-06-03 08:25:29

Названия юридических лиц и ИП

Метод: GET /api/normalizers/v1/firms

Описание
Эндпоинт выполняет нормализацию наименования юридического лица или индивидуального предпринимателя.
Преобразует полное наименование с возможными опечатками в стандартную сокращённую форму (ООО "Название", АО "Название", ИП "ФИО" и т.д.).

Параметры запроса

Параметр	Тип	Обязательный	Описание
`query`	string	Да	Название организации или ИП для нормализации
`upper`	any	Нет	Флаг возврата результата в верхнем регистре

Параметр query передаётся в URL-encoded виде (UTF-8).
Поддерживается наличие лишних пробелов, кавычек, запятых и типичных опечаток.
Если параметр upper не установлен, результат возвращается с сохранением регистра исходных данных

Примеры запросов и ответов

Ошибка — параметр не передан

GET /api/normalizers/v1/firms

Ответ:

HTTP/1.1 400 Bad Request
Content-Type: application/json

"не указан query параметр в запросе"

Пустой запрос

GET /api/normalizers/v1/firms?query=

Ответ:

""

ООО с опечатками

GET /api/normalizers/v1/firms?query=Общество с ограниченной ответственностью Академия-Медиа

Ответ:

"ООО \"Академия-Медиа\""

Физическое лицо (ИП)

GET /api/normalizers/v1/firms?query=Сорокина Ксения Сергеевна

Ответ:

"Сорокина Ксения Сергеевна"

Обработка кавычек и мусора

GET /api/normalizers/v1/firms?query=ООО 'Ромашка',

Ответ:

"ООО \"Ромашка\",\""

GET /api/normalizers/v1/firms?query="  ОАО Покемон  "

Ответ:

"\" ОАО Покемон \""

Особенности

Автоматическое определение формы собственности (ООО, АО, ПАО, ОАО, ЗАО, ИП, ГУП, ФГУП и др.).
Устойчивость к опечаткам — большой словарь распространённых ошибок.
Сохранение кавычек и остаточного текста после организационно-правовой формы.
Все сокращения в ответе заканчиваются пробелом перед открывающей кавычкой (например: ООО ").

Возможные коды ответа

Код	Описание
200	Успешная нормализация
400	Не передан параметр `query`