мы собираемся использовать интеграцию swaggerhub с Amazon API Gateway, имея команду разработчиков и старшего разработчика, которые будут публиковать изменения dev в prod API. Мы вообще не хотим предоставлять доступ к консоли aws разработчикам. Было бы замечательно, если бы им не пришлось заходить в swaggerhub и вручную редактировать API.
Вопрос в том, как нам это сделать?
Вот так я представляю себе это:
1) разработчик создает новый метод API,
2) добавляет разметку для swagger-php (или какой-либо другой библиотеки, похоже, что этот самый популярный atm?)
3) генерирует документы (которые можно просмотреть через swagger-ui)
4) синхронизирует его с dev API в swaggerhub (?)
5) dev API isинтегрированный и сохраненный в API-интерфейсе API Gateway и развернутый
6) после испытаний, API-интерфейс разработчика объединен с API QA и сохранен в API-интерфейсе API шлюза API, развернутый
7) послеобзор и тесты QA, dev API объединен с prod API (?)
8) prod API экспортирован в API Gateway и развернут
Во-первых, имеет ли это смысл? :) Если нет, то какой рабочий процесс вы бы предложили вместо этого?
Во-вторых, если это произойдет, как мы перейдем к шагу № 4 и 7?
Как нам автоматизировать процесс экспорта излокальные документы API, определенные в swaggerhub, и как мы можем объединить один API с другим в swaggerhub?