Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

Table of Contents
minLevel1
maxLevel2

...

  1. In the API Manager, go to the APIs & Proxies tab.

  2. Navigate to the Details page of the item you want to publish.

    • For API versions,

      • Click the API’s name in the list.

      • Go to the Versions tab.

      • Click the version number.

    • For Proxies, click the proxy’s name in the list.

  3. In the Version Details tab or Proxy Details tab, click Publish.

    API Manager - Proxy Details tab with the Publish button
  4. In the first Publish API dialog, configure the following settings:

    Publish API - first pageImage RemovedImage Added
    • Upload API Documentation: Choose one of the following options:

      • File from URL. References a file in the specified URL.

      • File from Version. Selects a file asset included in the API Version.

      • Local File. Uploads a file from your local machine.

    • Contact Email: The email address that an API consumer can contact about the API Version or Proxy.

    • Contact Slack: Slack channels and recipients (with the appropriate Slack URL) that an API consumer can contact about the API Version or Proxy.

    • Portal Categories: Select from the list of categories that are preconfigured for your Developer Portal.

      • (blue star)

    • Mark as Featured API: Showcase this API Version or Proxy by marking it as a Featuredin the Featured section of the Developer Portal.

  5. In the second Publish API dialog, configure the following settings:

    Publish API - second page
    • Under Subscription Settings:

      • Allow Subscriptions: If selected, API consumers can subscribe to this API Version or Proxy.

      • Auto Approve Keys: If selected, subscriptions are automatically approved.

    • Under Key Settings:

      • Custom Header: Specify the name of the custom header that will hold the subscribed application’s client key, when sending a request to call the API.

      • Query Parameter: Specify the name of the query parameter that will hold the subscribed application’s client key, when sending a request to call the API.
        IMPORTANT: If you modify these settings for an already published API, all existing subscriptions to the API will be invalidated.
        NOTE: If neither is specified:

        • If API is published with OAS 3.0 the API consumer must pass the secret key in the header as an Authorization key only.

        • If API is published with OAS 2.0 the API consumer must pass the secret key in the header as an Authorization key with the prefix Bearer.

  6. Click Publish and Exit.

...

  1. From the Publish API page, click the icon next to your selected file to open the API Specifications Editor.

    Image RemovedImage Added
  2. You can edit your API specs and view any errors with the code. Once you are done making changes, click Save to close this window. 

...

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

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

      Image RemovedImage Added
    • 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

Republish an API Version or Proxy to the Developer Portal

When an API version or Proxy is published, the status displays the Published status in the API Manager and Portal Manager. However, you can make changes to the Version specification and Assets or modify a Proxy, and publish the Version or Proxy again. The procedure is the same as Publishing an API version to the Developer Portal.

In the target API Version, click Publish; the procedure is the same as Publishing an API version to the Developer Portal:

  1. Modify the API Version settings as required.

  2. If needed, select another Snaplex to run the API version.

  3. Click Publish and Exit.

  4. In Portal Manager, check the status of the API Version or Proxy.

  5. In the Developer Portal, search for the new API version or Proxy.

Deprecating an API Version on the Developer Portal

...