Page Comparison

After creating an API, you might want to change its behavior, authentication mechanism, resources, throttling tiers, target audiences etc. at a later point in time, depending on new business or technical needs of the organization. But, you cannot do these changes to an API that is already published and has users plugged into it. A published API should be fixed. The way to modify it is by publishing a new version of the API with changes. Depending on the changes, you can decide to depreciate The general practice is to encourage users to adopt the new version by depreciating the old API after a defined period of time, so that the users have time giving them time to test their applications with the new API. 

The API Manager facilitates API versioning as part of API life cycle management. The steps below show how to create a different version of an existing API.1.

1. Log in to

...

1. the API Publisher

...

1. as a user who has

...

1. the

...

1. creator

...

1. role assigned. For more information on creating users and assigning roles, refer to section User Management.

...

1.  
2. Available APIs shows in the All APIs window of the API Publisher. Click on the API

...

1. that you want to create a version of.

...

Image Removed

...

1.  
2. The API's

...

1. Overview

...

1. tab opens. Create a copy of the API using the

...

1. Copy

...

1. button in the Overview tab. For example,
   Image Added
   

...

...

1. It opens a window allowing you to specify a new API version. Generally

...

1. recommended format

...

1. is version.major.minor

...

1. .
   

Image Removed

Click the "Done" button to complete.

...

1. Image Added
   
2. The newly-added version

...

1. appears in the

...

1. All APIs

...

1. window of API Publisher.

Image Removed

Once After creating the new version is created, a user who has the " publisher " role assigned can publish the API. When publishing, the "At the time you publish it, you can select the Deprecate Old Versions" option can be selected to automatically deprecate the all previous version versions of this the API. For instructions on publishing an API, refer to section Managing an API Life Cycle.