Проблема, которую я хотел бы решить: размещение экспортированного, преобразованного в Sphinx AWS файла API Gateway Swagger на readthedocs.
Проблема, с которой я столкнулся прямо сейчас: тупик в разработке. Я хотел бы:
- Экспортировать файл Swagger из API Gateway (с расширениями Api Gateway или без них)
- Изменить файл.
- Создать документы Sphinx используя измененный файл (например, с https://sphinxcontrib-redoc.readthedocs.io/en/stable/).
- Импортируйте измененный файл обратно в Api Gateway, чтобы зафиксировать изменения.
Проблемы:
А. (проблема с # 4) Если я экспортирую файл Swagger без расширений шлюза Api, он не может быть автоматически повторно импортирован, потому что я использую настраиваемый авторизатор.
Unable to put method 'DELETE' on resource at path '/cycle': Invalid authorizer ID specified. Setting the authorization type to CUSTOM or COGNITO_USER_POOLS requires a valid authorizer.
Б. (проблема с № 3) Если я экспортирую файл Swagger с расширениями шлюза Api, шлюз Api дублирует описания в части расширений файла Swagger. Это означает, что описания, используемые Sphinx, становятся отличными от описаний, используемых Api Gateway как часть # 2.
Прямо сейчас, кажется, лучший путь - использовать файл расширений Swagger и просто вручную отслеживать изменения. как в стандартных описаниях, так и в описаниях расширений, чтобы убедиться, что они совпадают.
Есть ли выход из этого леса, которого я не вижу?