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

Последнее обновление: 20.10.2026

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

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

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

Редактировать можно только последнюю версию, и создать новую версию можно только на ее основе. Более старые версии доступны только для чтения.

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

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

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

Примечание:

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

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

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

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

Публикация версии API в Qlik Catalog

Опубликуйте версию контракта API в пространство Qlik, чтобы участники совместной работы могли найти ее в Qlik Catalog.

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

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

На главной странице нажмите на версию, которую вы хотите опубликовать, чтобы открыть Предварительный просмотр, затем нажмите Опубликовать.
В диалоговом окне публикации выберите пространство Qlik, в котором вы хотите опубликовать версию.
Ознакомьтесь с предварительным просмотром версии и введите примечание к публикации.
Нажмите Опубликовать.

Выбранная версия публикуется в выбранное пространство Qlik и становится доступной только для чтения в контрактах API. Если вам снова потребуется отредактировать договор, сначала создайте новую версию.

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

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

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

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

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

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

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

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

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

Откройте Импорт содержимого версии для версии, которую вы хотите обновить.
Это действие недоступно для версии только для чтения.

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

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

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

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

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