What's API Gateway

webMethods API Gateway enables an organization to securely expose APIs to external developers, partners, and other consumers for use in building their own applications on their desired platforms.

It provides a dedicated, web-based user interface to perform all the administration and API related tasks such as creating APIs, defining and activating policies, creating applications, and consuming APIs. API Gateway gives you rich dashboard capabilities for API Analytics.

APIs created in API Gateway can also be published to API Portal for external facing developers’ consumption. webMethods API Gateway supports REST-based APIs and SOAP-based APIs, provides protection from malicious attacks, provides a complete run-time governance of APIs, and information about gateway-specific events and API-specific events.

API Gateway Features

API Gateway provides these key features:

Tenant Management

SoftwareAG provisions API Cloud in Software AG Cloud platform based on your geographical location.

Software AG Cloud platform has its own Tenant Management System to authenticate users. Once a user registers with API Cloud, the corresponding Tenant Management System initiates the user registration process.

When you sign up for a webMethods.io API Gateway trial tenant, the Free forever edition is assigned by default. You can then optionally upgrade to the paid plans like Basic, Advanced, or Enterprise based on your requirement. For more details, see the Pricing tab of webMethods.io API in SoftwareAG Cloud site.

Configuring the Number of APIs listed on a Page

You can configure the number of APIs that get listed per page in the Manage APIs or the Manage applications page. In each of these pages, you can use the pagination bar at the bottom of the page to navigate from one page to another, the first page, or the last page when there are more than 20 APIs in the list. To change the number of APIs listed in a page, select the required number in the Show # results per page field in the pagination bar at the bottom of the page. The API list now displays only those many APIs in one page as specified. For example, if you select Show 10 results per page, only 10 APIs are listed in one page.

This configuration that you change through the drop down is maintained as long as you are logged in to API Gateway.

The value is set in the drop down is applicable for both APIs and applications listing. For example, if you change the show results to 10 in the Manage APIs drop down, then the number is retained for Manage applications page as well.

Using Help

API Gateway’s help gives an overview of the functionality of API Gateway.

You can access API Gateway Help link by clicking icon , in the title bar and selecting Help. This opens the introduction to the webMethods API Gateway page in the help system. You can browse the required topics in the navigation pane. Click on a topic to display the detailed information. You will also find the help links in the form of a help icon icon on several pages of the API Gateway user interface. Click the help icon icon on the page to view the corresponding detailed information.

Managing Upgrades and Fixes

API Gateway UI enables you to upgrade to the latest fix. When a new fix is released, it shows up in the About page of API Gateway.

In the API Gateway versions, 10.12 Fix 3 and above, the Fix management section on the About page displays information about two latest versions. API Gateway UI enables you to choose and upgrade to a version of your choice.

Note: To upgrade to 10.15 version from 10.12 Fix 1 or Fix 2, contact Software AG Support.

From 10.12 Fix 3, SoftwareAG provides automatic upgrades to the next major version for customers under the new contract. As per the new contract, you must upgrade to the latest major version within 60 days from the release date. The API Gateway UI alerts you about the latest major version upgrade every time you log in. In addition, Software AG sends a reminder email once on the 30th and every day from the 45th day to upgrade. Finally, when the 60 days grace period expires, Software AG automatically upgrades your tenant to the latest major version.

Note: You can schedule upgrade to minor versions (fixes) at your convenience. Minor version upgrades do not have a grace period.

To perform any upgrade , you must be an API Gateway Administrator.

Upgrading to a new version

To upgrade to a new version:

  1. Click from the title bar and select About.
    You can view the Product information section and Fix management section in the About page. The Product information section has the edition name and the current version of your API Gateway.

  2. In the Fix Management section, you can view the following details on the next available fix:

    • Version number. The version number of the next available fix is displayed. In the API Gateway versions 10.12 Fix 3 and above, you can view two latest versions in the drop down. You can choose and upgrade to the version of your choice.

    • Readme document. The Readme document of the next fix is available for download. You can download the Readme document by clicking the link Click here to download. In the API Gateway versions 10.12 Fix 3 and above, You can download the Readme document of the version you choose.

  3. Click Schedule upgrade.

  4. In the Schedule upgrade section, perform the following:

    a. Click Date and select a date for the upgrade.
    The selected date lies within the next 15 days.
    You can select the date within the 60-day grace period if you are in the new contract from 10.12 Fix 3 onwards.

    b. Click Time and select a time when the upgrade should be done.
    The immediate time available for selection is one hour later than the present time. You can not schedule the upgrade during the restricted time frame, which is 9:30 PM to 12:30 AM UTC due to internal maintenance.

    c. In the Email IDs field, type email addresses of the personnel to be notified when the upgrade is scheduled and click .
    You can add multiple email addresses to be notified.

  5. Click Save.
    The schedule is listed in the schedule table. You can edit or delete the schedule by clicking on the appropriate action icons.

    Software AG sends an email about the upgrade scheduled, upgrade initiation and upgrade completion to tenant owners and respective email addresses.

    Note: At a time, only one upgrade operation is allowed.