Живая документация: трансформация API HeadHunter
HeadHunter перевёл документацию API с Markdown на OpenAPI, сделав её интерактивной и автоматизировав генерацию кода и тестов.
- Tagline Awards2025— Лучший аутстаф-проект
Задача
Документация API HeadHunter велась в устаревшем формате Markdown, что усложняло работу разработчиков, требовало ручного тестирования и затрудняло синхронизацию русской и английской версий.
Решение
Выполнена миграция на OpenAPI: создана централизованная спецификация, автоматизированы генерация DTO-классов и тестов, внедрена валидация ответов API, настроена синхронизация двуязычной документации и проведён рефакторинг legacy-кода.
Результат
Разработчики и интеграторы получили интерактивную документацию с примерами запросов и ответов, автоматической валидацией и генерацией кода, что снизило количество ошибок и ускорило разработку.
4 место в категории Сервис поиска работы
Похожие кейсы
Платформа управления знаниями TEAMLY: 35 000+ пользователей и 235 компаний
Разработана платформа TEAMLY для управления знаниями, заменившая Confluence и Notion: более 235 компаний и 35 000+ пользователей.
Сайт и редизайн редактора презентаций Slider Ai за 2 месяца
Обновили сайт и редактор презентаций Slider Ai: снизили отказы в 1,5 раза и ускорили загрузку до 100/100 по Lighthouse за 2 месяца.
За 2 недели мигрировали 20 000+ аккаунтов с Notion на российскую платформу TEAMLY
За 2 недели до блокировки Notion в России платформа TEAMLY помогла мигрировать более 20 000 аккаунтов, 90% переносов прошли успешно.
Сервис оценки и развития разработчиков
Создали открытый сервис и базу знаний для оценки навыков разработчиков по объективным критериям.
Мокапус — генератор анимированных трехмерных мокапов онлайн
Создали онлайн-генератор анимированных 3D-мокапов для презентации дизайна.
Приоритет: ребрендинг и комплексное сопровождение федеральной программы
Разработали цифровую платформу для программы «Приоритет 2030»: весь процесс от подачи заявок до выдачи грантов переведён в онлайн, а согласование изменений сократилось до недели.