Если вы получаете ошибки при импорте документа OpenAPI, убедитесь, что вы проверили его - либо с помощью дизайнера на портале Azure (Design - Front End - Редактор спецификаций OpenAPI), либо с помощью стороннего разработчика. такой инструмент, как Swagger Editor .
· Поддерживается только формат JSON для OpenAPI.
· Обязательные параметры для пути и запроса должны иметь уникальные имена. (В OpenAPI имя параметра должно быть уникальным только внутри местоположения, например, путь, запрос, заголовок. Однако в API Management мы позволяем распознавать операции как по параметрам пути, так и по параметрам запроса (которые OpenAPI не поддерживает). Поэтому нам требуется имена параметров должны быть уникальными во всем шаблоне URL.)
· Схемы, на которые ссылаются свойства $ ref, не могут содержать другие свойства $ ref.
· $ ref указатели не могут ссылаться на внешние файлы.
· x-ms-paths и x-server являются единственными поддерживаемыми расширениями.
· Пользовательские расширения игнорируются при импорте и не сохраняются и не сохраняются для экспорта.
Для более подробной информации, вы можете обратиться к этой статье .