Как AI помогает проектировать API

Александр Поломодов и Павел Каравашкин разбирают AI-Enhanced API Design — продолжение разговора об API governance. Опыт Google сравнивают с T-API Т-Банка: масштабы и централизация различаются, но обе организации стремятся сделать проектирование контрактов последовательнее и безопаснее.

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

Эксперимент делит участников на три группы: стандарты с линтером, только стандарты и обычный процесс. За два часа инженеры проектировали API, записывали экран и заполняли опрос; фрагменты контрактов затем сравнивали по качеству. Кодированные правила с быстрой обратной связью помогали, а одних документов оказалось недостаточно.

Низкая доля участников и искусственная задача ограничивают переносимость цифр. Вывод шире одного инструмента: работу надо раскладывать на наблюдаемые действия, а AI подключать там, где есть контекст и проверяемый результат. В T-API интересна автоматизация security review, но ответственность за контракт остаётся у людей.