Trabajar con varias versiones

API Designer le permite trabajar con varias versiones de la misma definición de API para ayudarle a gestionar el ciclo de vida de su API. Puede hacer lo siguiente:

Mantenga una versión de API previa en producción, mientras introduce cambios significativos o disruptivos en una nueva versión.
Obtenga visibilidad y control sobre las versiones publicadas.
Obtenga flexibilidad al diseñar cambios en una API.

Cuando crea una nueva versión de una API, todo el contenido se copia a la nueva versión y cada versión se puede modificar de forma independiente sin afectar a las demás.

La página de inicio de API Designer muestra todas las API de su propiedad y todas las versiones de API compartidas con usted.

Crear una nueva versión de API

Crear una nueva versión de una definición de API existente.

Usted es propietario de la API o editor de al menos una versión de la API.

En la página de inicio, vaya a la API para la que desea crear una nueva versión.
Puede filtrar la lista por nombre o propietario si es necesario.
Haga clic en el botón junto a la versión que desea copiar y haga clic en Crear una nueva versión a partir de <version>.
Introduzca la nueva versión.
Haga clic en Crear.

Se crea una nueva versión de su API con el mismo contenido que la versión de origen. La simulación y la documentación están deshabilitadas de forma predeterminada.

Eliminar una versión de API

Usted es propietario de la API.

En la página de inicio, haga clic en el botón junto a la versión que desea eliminar y haga clic en Eliminar.
Haga clic en Eliminar para confirmar.

La versión seleccionada se ha eliminado. Si desea eliminar una API completa, debe eliminar cada versión.

Importar contenido de la versión

Importar contenido de un contrato existente a una versión de API, reemplazando o fusionando su contenido actual.

Usted es propietario de la API o editor de la versión de la API.

Utilice esta función para actualizar una versión desde un archivo de contrato externo sin crear una nueva versión. El identificador de la versión se conserva durante toda la importación.

Esto es diferente de importar una definición, que crea una nueva API en API Designer.

Abra Importar contenido de la versión para la versión que desea actualizar.
Puede acceder a esta acción desde las siguientes ubicaciones:
- En la página de inicio, haga clic en el botón de menú junto a la versión y haga clic en Importar contenido de la versión.
- En la página de inicio, seleccione la versión para abrir el panel de detalles y, a continuación, haga clic en Importar contenido de la versión.
- En el editor de versiones, haga clic en Editar > Importar contenido de la versión.
Seleccione un formato y un origen para el contrato que desea importar.
Puede importar desde un archivo local, una URL o texto que pegue directamente en el cuadro de diálogo.
En Comportamiento, seleccione cómo aplicar el contenido importado.
- Reemplazar: sobrescribe todo el contenido actual con el contrato importado. Se conservan el nombre de la API, el identificador de versión y la versión de la especificación.
- Fusionar: combina el contenido importado con el contenido de la versión existente. El nombre de la API y el identificador de versión se conservan. Si un elemento importado tiene el mismo nombre que un elemento existente, el elemento importado se renombra con un sufijo _merge (por ejemplo, User_merge). Las URL base y los tipos de medios duplicados se omiten.
Haga clic en Importar.

El editor de versiones se abre con el contenido actualizado aplicado.

¿Esta página le ha sido útil?

Si encuentra algún problema con esta página o su contenido (errores tipográficos, pasos que faltan o errores técnicos), no dude en ponerse en contacto con nosotros.

Deje aquí sus comentarios