Работа с несколькими версиями

API Designer позволяет работать с несколькими версиями одного и того же определения API, чтобы помочь вам управлять жизненным циклом API. Вы можете:

Поддерживать существующую версию API в рабочей среде, внося значительные или критические изменения в новую версию.
Получить наглядность и контроль над опубликованными версиями.
Получить гибкость при проектировании изменений в API.

При создании новой версии API все содержимое копируется в новую версию, и каждую версию затем можно изменять независимо, не затрагивая остальные.

На главной странице API Designer отображаются все API, владельцем которых вы являетесь, и все версии API, к которым вам предоставлен доступ.

Создание новой версии API

Создание новой версии существующего определения API.

Вы являетесь владельцем API или редактором хотя бы одной версии API.

На главной странице перейдите к API, для которого требуется создать новую версию.
При необходимости список можно отфильтровать по имени или владельцу.
Нажмите кнопку рядом с версией, которую требуется скопировать, и нажмите Создать новую версию из <version>.
Введите новую версию.
Нажмите Создать.

Создается новая версия API с тем же содержимым, что и исходная версия. Макет и документация по умолчанию отключены.

Удаление версии API

Вы являетесь владельцем API.

На главной странице нажмите кнопку рядом с версией, которую требуется удалить, и нажмите Удалить.
Нажмите Удалить для подтверждения.

Выбранная версия удаляется. Если вы хотите удалить весь API, необходимо удалить каждую версию.

Импорт содержимого версии

Импорт содержимого из существующего контракта в версию API с заменой или объединением ее текущего содержимого.

Вы являетесь владельцем API или редактором версии API.

Используйте эту функциональность для обновления версии из внешнего файла контракта без создания новой версии. Идентификатор версии сохраняется на протяжении всего импорта.

Это отличается от импорта определения, при котором создается новый API в API Designer.

Откройте Импортировать содержимое версии для версии, которую требуется обновить.
Доступ к этому действию можно получить из следующих мест:
- На главной странице нажмите кнопку меню рядом с версией и нажмите Импортировать содержимое версии.
- На главной странице выберите версию, чтобы открыть панель сведений, затем нажмите Импортировать содержимое версии.
- В редакторе версий нажмите Изменить > Импортировать содержимое версии.
Выберите формат и источник для импортируемого контракта.
Вы можете импортировать из локального файла, URL-адреса или текста, вставленного непосредственно в диалоговое окно.
В разделе Поведение выберите способ применения импортированного содержимого.
- Заменить: перезаписывает все текущее содержимое импортированным контрактом. Имя API, идентификатор версии и версия спецификации сохраняются.
- Объединить: объединяет импортированное содержимое с содержимым существующей версии. Имя API и идентификатор версии сохраняются. Если импортированный элемент имеет то же имя, что и существующий элемент, импортированный элемент переименовывается с суффиксом _merge (например, User_merge). Повторяющиеся базовые URL-адреса и типы мультимедиа пропускаются.
Нажмите Импортировать.

Откроется редактор версий с примененным обновленным содержимым.

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице или с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом!

Оставьте свой отзыв здесь