Publish an API to Developer Portal

Edit online

You can expose APIs that you create in webMethods API Gateway to consumers by publishing them to a webMethods Developer Portal. webMethods Developer Portal lists the published APIs and their versions, provides documentation of their functionality and allows to register applications.

This section describes how to configure a webMethods Developer Portal instance as a destination, publish your Search Cruise REST API to webMethods Developer Portal, view the published API from webMethods Developer Portal, and try out the API in webMethods Developer Portal.

Before you begin

Ensure the Search Cruise API you want to expose is created.

To publish an API to Developer Portal

  1. Ensure you have configured webMethods Developer Portal as a destination to publish your API.
    If you have not configured the destination, perform the following steps:
    • Log onto webMethods API Gateway instance.
    • Expand the menu options icon menu_options, in the title navigation bar.
    • Select Administration.
    • Click Destinations > API Portal > Configuration
      destination configuration
    • Provide the Username and Password for webMethods API Gateway configuration.
    • Click Publish to save the destination details.
  2. Ensure the API you want to publish is activated.

    This is required so that the consumers can access the gateway localhost and use the API.

    If the API is not in active state, perform the following steps:
    • Click APIs on the title navigation bar.
    • Select Search Cruise API from the list of APIs and click Activate to activate the API.
  3. Publish the API to webMethods Developer Portal.
    • Click APIs on the title navigation bar to view the API list.
    • Click publish icon for the Search Cruise API.
    • Select webMethods Developer Portal and select the required communities. The default community is public, and all users have access to this community.
      published api
    • Click Publish.

      The API is published to webMethods Developer Portal. A success message displays when the API is successfully published to webMethods Developer Portal.

  4. View the published API in webMethods Developer Portal.
    • Log onto webMethods Developer Portal instance.
    • Click API gallery in the title navigation bar.

      You can see the published API.

      api gallery in developer portal
  5. Try out the API.
    • In the API gallery page, click View details > Try API for Search Cruise.
    • Select a stage of the API you want to test in the Environment field.

      The applications associated with the selected stage appear in the Applications field.

    • Click the Application to be tested and select a resource from the list that appears.
    • Select a method and type in a value for the path and query parameters and its corresponding value.
    • Select Authorization > Authorization type and provide the corresponding API key.
    • Type in the required Header names and corresponding values in the Headers tab.
    • Click Send.

      The request and the response of the API appear.