api.boevayaslava.ru: первый открытый API по справочникам ВОВ

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

На самом деле это не шифр. Это язык военного времени. Его можно прочитать, если знать, где искать.

За годы работы «Боевой славы» мы много раз проходили один и тот же путь: получали от людей адрес из письма, открывали справочники, сверяли номера, разбирали сокращения, проверяли подчинение частей, искали, как эти строчки связываются с историей Победы. Потом этот опыт лег в цикл статей «Между строчек Великой Отечественной войны», а позже – в бота «Боевой славы» (Telegram | MAX).

Но между большим циклом статей и умным ботом не хватало еще одного слоя: открытого поиска и публичного API по самим справочникам.

Именно его мы сейчас и выводим в публичный доступ:

Перейти к справочникам «Боевой славы»

1. Зачем нужен отдельный поиск

Когда человек ищет историю своего деда или прадеда, он обычно начинает не с архивной методики, а с того, что у него под рукой.

Например:

• ппс 1436
• в/ч пп 594
• 838 сп
• 01001
• сад

Для специалиста это нормальные рабочие зацепки. Для новичка – тупик. Поисковик выдаёт форумные темы, старые таблицы, отрывки справочников, похожие номера, но не всегда понятно, что из этого имеет отношение именно к вашему письму.

Военный поиск часто начинается не с фамилии, а с адреса. Адрес кажется маленькой строкой, но за ним может стоять полк, дивизия, армия, фронт и конкретный эпизод Великой Отечественной войны.

Наша задача – сделать первый шаг максимально простым. Не заменить архивную работу, не отменить проверку источников, не выдать красивую легенду вместо факта. А дать человеку аккуратную точку входа: что означает найденный номер или сокращение и в каком направлении копать дальше.

2. Почему именно эти справочники

Мы не выкладываем наружу всё подряд. В первом публичном поиске и API открываем ровно тот набор справочников, на котором держится наш алгоритм разбора фронтовых адресов из статей «Между строчек ВОВ».

Во второй части мы собрали общий алгоритм и показали три типа фронтовых адресов. Дальше каждая часть серии подробно разбирала свой тип:

• тип 1: п.п.с. + наименование части – здесь нужен справочник полевых почтовых станций;
• тип 2: п.п.с. + условный номер части – здесь нужны и справочник п.п.с., и справочник условных номеров частей;
• тип 3: пятизначные номера в/ч-п/п – здесь нужен справочник войсковых частей – полевых почт.

Четвертый справочник -- сокращения. Он не является отдельным типом фронтового адреса, но без него легко перепутать сп, сд, ап, омсб, сад, минп и построить дальнейший поиск на неверном основании.

Иными словами, в первый публичный API вошли те самые справочники, необходимые для расшифровки фронтового адреса:

• п.п.с. – полевые почтовые станции;
• условные номера частей – связка п.п.с. и условного номера части;
• в/ч-п/п – пятизначные номера войсковых частей – полевых почт;
• сокращения – вспомогательный справочник для расшифровки наименований частей и соединений.

Важно: эти данные не рождаются внутри нашего приложения. Они уже были найдены и опубликованы в виде веб-страниц, сканов, таблиц или статей. Новое здесь другое: впервые все эти источники сведены в один контролируемый публичный API, по которому можно искать программно и который можно использовать ИИ-агентам.

3. Оригинальные источники

Справочники, на которых построен первый публичный поиск:

• Справочник п.п.с. РККА 1941-1945 гг. на СОЛДАТ.RU: www.soldat.ru/pps.html. Описание справочника: www.soldat.ru/pps_about.html.
• Справочник войсковых частей -- полевых почт на СОЛДАТ.RU: www.soldat.ru/pp_v_ch.html. Описание справочника: www.soldat.ru/pp_v_ch_about.html.
• Справочник условных номеров частей опубликован не одной таблицей, а разделами по фронтам и армиям. Вводная публикация И.И. Ивлева: «Сводные справочные сведения о соответствии условных номеров в/ч их действительным наименованиям». Полный указатель разделов и примеры работы с ним приведены в нашей статье про адреса типа 2.
• Справочник армейских сокращений, который мы используем при разборе наименований частей, основан на распространённой в сети версии с большим количеством уточнений в ходе общения с Станиславом Рачинским, создателем сайта rkka.wiki.

4. Как искать

Интерфейс специально сделан без лишней торжественности. Поле запроса, выбор справочников, кнопка поиска, результаты.

Можно искать по всем справочникам сразу. Можно сузить поиск, если вы уже понимаете, что вам надо расшифровать именно номер ППС или именно сокращение.

Поиск показывает разные степени совпадения:

• точное совпадение -- когда запись найдена практически в лоб;
• совпадение в начале -- когда введенная строка совпадает с началом номера или значения;
• частичное совпадение -- когда искомый фрагмент найден внутри записи.

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

Например, человек может набрать не полный номер, а только 776. В таком случае система не должна пожать плечами. Она должна показать, где этот фрагмент встречается, подсветить найденное место и предупредить, если совпадений слишком много.

Широкие запросы вроде 1 или сп мы тоже не запрещаем. Иногда именно с них начинается поиск. Но если результатов слишком много, поиск честно скажет: это очень широкий запрос, показана только ограниченная часть выдачи. Лучше уточнить номер, дату, тип справочника или соседние слова из письма.

5. Почему не выложить просто таблицу?

Да, проще было бы выложить четыре эксельки и сказать: «ищите сами». Но на дворе 2026 год. Мы делаем ставку на то, что вы отдадите API своему Codex, OpenClaw или Hermes и напишете с ним навыки, чтобы он сам искал нужные данные.

Изнутри публичный поиск устроен достаточно сложно:

• исходные справочники Excel пока остаются источником истины;
• для работы сайта они собираются в небольшую базу SQLite;
• браузер обращается к справочникам с конкретным запросом через API;
• наружу отдаются только запрошенные данные;
• запросы ограничены по частоте, чтобы общедоступный сервис не перегрузили случайными запросами и не уронили автоматическим перебором;
• ответы выдаются «страницами» (т.н. «пагинация»);
• найденные совпадения подсвечиваются.

Это скучные инженерные детали, но без них хороший исторический инструмент очень быстро превращается в хаос. Особенно когда речь идет не о декоративном «поиске по сайту», а о справочниках, которыми люди будут пользоваться для реального семейного поиска.

6. Чем справочники отличаются от бота

Почтовый бот «Боевой славы» пытается понять человеческий запрос целиком. Ему можно написать примерно так:

где была ппс 1436, 64 гв сп, 3-я минометная рота

Бот разберет намерение, выделит адрес, обратится к справочникам, попробует собрать ответ и подсказать дальнейший путь.

Справочники просто подсказывают, за что можно зацепиться.

Чтобы задать сложный вопрос, надо хорошо разбираться в теме. Но для этого надо потратить кучу времени, которого обычно нет. Открытые справочники решают задачу сокращения времени, которое требуется для погружения в тему сокращений, полевых почт и войсковых частей Великой Отечественной войны.

7. Немного о данных и приватности

Мы будем смотреть на поисковые запросы, потому что без этого невозможно улучшать инструмент. Именно реальные запросы показывают, как люди на самом деле ищут: где ошибаются, что вводят вместо номера, какие сокращения вызывают путаницу, какие справочники стоит добавить следующими.

Но это должно быть сделано аккуратно.

Поэтому в приложении есть согласие на cookie и аналитика. Текст согласия простой:

Мы используем файлы cookie для анализа вашего опыта и оптимизации работы сайта – только с вашего согласия, разумеется.

Если человек не хочет соглашаться – поиск должен оставаться доступным. Мы не делаем из cookie входной билет в память о семье.

8. Что дальше

Первый публичный поиск и API по справочникам – это не финальная точка. Это базовый инструмент, который должен стать частью большой системы «Боевой славы».

Дальше есть несколько очевидных направлений:

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

В идеале человек должен пройти путь от старого письма до осмысления боевого пути своего прадеда в Великой Отечественной войне без ощущения, что он попал в лабиринт архивных таблиц.

Это, конечно, амбициозно. Но вся «Боевая слава» с этого и началась: с мысли, что память не должна быть закрытой территорией для специалистов. Если в семье осталось письмо, фотография, похоронка, строчка из военкомата или просто рассказ бабушки, у человека должен быть шанс понять, за что зацепиться.

Справочники – маленький, но очень важный шаг в эту сторону.

Открыть поиск по справочникам «Боевой славы»