3.4. Create an API

Creating an API is the first step to building an API. It involves naming and describing an API and allocating it as a SOAP or REST API. For more information on APIs, refer: API.

This short section takes you through the task of creating an API.

In this Section:

Before you begin:

  • Make sure you are logged in to the DigitMarket™ API Manager Publisher Portal using your sub-organizational level credentials. To learn about how to log in to the Publisher portal, visit Log in to the Publisher Portal
  • If not stated otherwise, the term “API” appearing in this section refers to an API version.
  • The fields marked with asterisks are mandatory

Following UI screens are referenced in this section:

  • APIs screen

    APIs screen

    Fig. 3.49 APIs screen

    The APIs screen lists all APIs irrespective of whether they are in Draft, Approved or other States.

  • Add New API

    Add New APIs

    Fig. 3.50 Add New APIs

  • API Configuration screen

    API Configuration screen

    Fig. 3.51 API Configuration screen

Common Tasks

Following are the common tasks identified for this section:

  • Navigating to the APIs screen

    To navigate to the APIs screen:

    • In the main navigation menu, click APIs.

    The APIs screen displays.

    Navigate to APIs screen

    Fig. 3.52 Navigate to API screen

    • Alternatively, you can click APIs summary total on the homepage to display the APIs screen.
    Navigate to APIs screen

    Fig. 3.53 Navigate to APIs screen

  • Navigating to the API Configuration screen

    To navigate to the API Configuration screen:

    1. Navigate to the APIs screen.
    2. In the APIs screen, click the row that has the API you want to configure. The API Configuration screen displays.
    API Configuration screen

    Fig. 3.54 API Configuration screen

    The API Configuration screen consists of tabs for adding and editing resources/operations, configuring endpoints, and handling Transformations, Data Recording and Schema Validation. The API Action menu control allows you manage approval workflows, Versioning and Visibility of an API.

3.4.1. Assign a Name and Type to an API

To assign a Name and Type to an API:

  1. Navigate to the APIs screen.

  2. In the APIs screen, click New API at the top right corner of the screen.

    New API

    Fig. 3.55 New API

    The Add API dialog box displays.

    Add API dialog

    Fig. 3.56 Add API dialog

  3. In the API Name box, type a name for your API.

  4. Type a short description for your API. The short description that you type here is populated in the Short Description box of the Overview tab in the API Configuration screen.

  5. Click the API Type drop-down box to select the API type. You can select either REST or SOAP as the API type.

  6. Click Add to finish creating the API. The newly created API is populated in the APIs screen.

    Note

    SOAP API icons have an ‘S’ and REST an ‘R’ to differentiate them from each other.

    Note

    Once an API is created, the API Type cannot be edited or changed.

Next Steps

The next section covers the steps necessary to edit and configure API resources/operations and endpoints. You will learn to manage API Transformations, add an API Version and also set its Visibility.