OpenAPI (раньше назывался Swagger) — спецификация для описания REST API в формате YAML или JSON. Ты описываешь эндпоинты, параметры, тела запросов и ответов, коды ошибок — и из этого автоматически генерируется интерактивная документация, клиентские SDK и даже серверные заглушки. Swagger UI показывает красивую страницу, где можно прямо в браузере отправлять запросы к API. В Go-проектах часто используют swaggo/swag, который генерирует OpenAPI-спеку из комментариев в коде. Мы используем protobuf + grpc-gateway, что по сути решает ту же задачу.

Что такое OpenAPI/Swagger?