Что такое OpenAPI spec?

OpenAPI (бывший Swagger) — стандарт описания REST API в YAML или JSON формате. Описывает: пути, методы, параметры, тела запросов/ответов, схемы данных, auth. Из спеки можно сгенерировать: документацию (Swagger UI), клиентские SDK (openapi-generator), серверные стабы, тесты. В Go можно писать spec вручную или генерировать из кода (swaggo, ogen). Версии: OpenAPI 3.0 — текущий стандарт, 3.1 — полная совместимость с JSON Schema.