Skip to main content
Skip table of contents

Importing APIs

Instead of creating an API, you can also import an API. There are two different ways to import APIs:

  1. Import from API Catalog
  2. Import from the organization details page

Import from API Catalog

The catalog is supplied along with API Management. You can find it in the sidebar menu, item APIs.

The API Catalog lists all SOAP or REST services provided by the Scheer PAS integration component.

Three different filter options allow to search the catalog:

  • Text filter: Filters by API name.
  • Tag filter: Every service contains a tag corresponding to the category of an xUML service (see BRIDGE Documentation for further information on frontend components). Use this filter to list all services with the same tag.
  • Type filter: Displays all REST or all SOAP services.

Search the catalog to find the API you want to use.

Click Import on the API tile.

The Import API dialog opens.

  • Choose the Organization you want to import the API to.
  • The API Name is taken from the catalog, but you can revise it in this field if you want to.
  • Insert an Initial Version for the API and a Description.

Click Import to start the API import, or Cancel to abort.

After a successful import, the detail page of the API is displayed and you can directly customize the imported API:

Refer to Finding APIs to learn more about the configuration options of APIs.

Import from Organization Details Page

You can also start an API import from the organization details page. Choose option Organizations > My Organizations from the sidebar menu and open the details page of one of your organizations. If you go to tab APIs of the organization, a button Import from API Catalog will be displayed on top right:

Page Import from API Catalog opens. It enables you to directly import the desired API(s) to the corresponding organization in three steps:

Step 1: Select APIs

In the first step, use the search field to find the API you wish to import and click Add to select it. The selected APIs will be listed underneath the search list. Use the link Remove if you have added an API by mistake. You can repeat this process as often as you like.

Once you have selected the API or APIs you wish to import, click Next to continue:

If the Add link is missing in column Actions, an API with the same name already exists in your organization. In that case, you cannot add this API.

Step 2: Choose Plans

In the second step, choose whether these APIs should be public or private:

OptionDesciption
Public API(s)Enable checkbox Make imported API(s) public if you want the imported API(s) to be accessible by any invoker.
Available Plans

Choose the plan or the plans that should be presented to a client who wants to create a contract to this API.

Plans must be locked to be available in this section. On page Locking a Plan you can find out how to lock plans.
Go to Creating a Contract to learn how to create a contract.

Click Next to continue.

Step 3: Import APIs

In the last step, you need to confirm that you want to import the selected APIs. Once you click the button Import, all selected APIs will be added to the organization:

Success or failure of each API import will be shown as it happens. Click Finish to complete the import:

You will return to the organization details page, where the imported APIs are listed in tab APIs:

Related Documentation:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.