Я прочитал тонны документации о плюсах и минусах управления версиями URI против версий заголовка (тип носителя) ( Рекомендации по управлению версиями API? ).
Если я хочу выбрать носитель управление версиями типа, как лучше всего документировать мой API? Я использую Swagger (2.0) и изучил также OpenAPI 3.0, но я не смог найти простой и понятный способ выставления разных версий для одной и той же конечной точки.
Я хотел бы получить ясную и простой и понятный способ поделиться моими определениями API с моими интеграторами.