Managing the API Lifecycle

In this article

Overview

You can make your APIs accessible to users outside of the SnapLogic ecosystem in the API Portal. The API Management > Portal Manager enables you to publish, unpublish, deprecate, and retire versions of your API. As an Org Admin, you can create an Developer Portal for your API developers to publish their APIs. The API Management > Portal Manager is the administrative console where you can manage the lifecycle of your APIs. The Developer Portal is the public facing page that consumers use to explore those APIs.

You can perform the following actions in the Portal Manager:

  • View APIs published on the Developer Portal. The API is available as read-only with documentation included for the interested consumer.

  • Unpublish an API version from the portal to update any of its components. The API is removed from the Developer Portal, but can be published again in the API’s Version Details page.

  • Deprecate an API version to notify users that this version of the API is obsolete. The API is marked Deprecated in the Developer Portal and Portal Manager. A deprecated API can still be updated and published again, but once it is marked deprecated, the API version status cannot change to any other but Retired.

  • Retire an API version from the Developer Portal. The API is removed from the Developer Portal and Portal Manager, and can no longer be updated or published. Tasks are disabled and assets become read-only in the UI.

Publishing an API version to the Developer Portal

  1. In API Management > API Portal Manager, navigate to the target API version, then click Publish.

     

  2. In the Publish API dialog, enter the following information:

    • Upload API Documentation: Choose one of the following options:

      • File from URL. Reference a target endpoint through a URL.

      • File from Version. Select the file used from the API Version.

      • Local File. Select a file from your local system.

    • Contact Email: Enter the contact email for the API consumer.

    • Contact Slack: Enter Slack channels and recipients. with the appropriate Slack URL.

    • Portal Categories: Enter preconfigured categories.

       

  3. Review details and click Publish.

To confirm the publication of your API, you can navigate to the target Version and view its Publication status. You can also view the publication status in the API Management > Portal Manager page.

Unpublishing an API Version from the Developer Portal

When you unpublish an API version, that API is removed from the Developer Portal but remains in the Portal Manager.

  1. In the API Management console , perform one of the following actions:

    • In API Manager, navigate to the target API version, then click Unpublish.

    • Click Portal Manager, scroll to the target API, and in the Actions column, click Unpublish.

       

  2. Review the Unpublish API confirmation prompt, then click Unpublish.

To verify that the API version is unpublished, check the status in the Portal Manager or Version Details of the API version.

To publish the API again, click Publish; the procedure is the same as Publishing an API version to the Developer Portal.

Deprecating an API Version on the Developer Portal

When you deprecate an API version, you can still update the assets used in that version and apply API policies, as well as publish, and unpublish it to the Developer Portal. However, the version in the Developer Portal is marked as deprecated, with the expectation that it could be retired.

  1. In the API Management console, complete one of the following actions:

    • In API Manager, navigate to the target API version, then click Deprecate.

    • Click Portal Manager, scroll to the target API, and in the Actions column, click Deprecate.

       

  2. Enter a message for the consumers of this API version, and click Deprecate.


    To verify that the API version is deprecated check the status in the Portal Manager or Version Details of the API version.

Retiring an API Version

When you retire an API version, API consumers can no longer view it in the Developer Portal. You can no longer modify or republish a retired API version. You must deprecate the API version before retiring it.

  1. In the API Management console, complete one of the following actions:

    • In API Manager, navigate to the target API version, then click Retire.
      The Status must be Deprecated to enable the Retire button.

    • Click Portal Manager, scroll to the target API, and in the Actions column, click Retire.

       

  2. Review the Retire API confirmation prompt, then click Retire.

     

To verify that the API version is Retired from the Developer Portal, check the status in the Version Details of the API version. The retired API version is no longer displayed in the Portal Manager or the Developer Portal.

When an API is retired in the Portal Manager, all Tasks get disabled, and assets become read only in the UI.