PAS 22.1 Your created APIs are available for your customers and their developers within the API Developer Portal (refer to Exposing an API for further information).

Contents of the API Developer Portal

The API Developer Portal is fully customizable, you can determine its contents yourself (refer to Customizing the Developer Portal for details). The default template contains the following content:

Home

Home is the landing page of the API Developer Portal. You determine yourself, what is displayed on this page: In API Management, select the option Feature this API for every API that should appear on the portal start page (refer to Exposing an API for details).

Tip

title	Expert Advice

Use this feature to highlight some of your APIs, e.g. the most wanted or the latest APIs.

Marketplace

The Marketplace is where all exposed APIs are displayed. Developers can use the filter to search the whole variety of your APIs.

My Clients

In the My Clients tab, every portal user gets an overview on his clients and the APIs he subscribed to.

The navigation on the right side supports the user to browse the page.

Additional Tabs

You can customize your API Developer Portal and add further tabs, for example a tab Support to connect your own customer support service desk.

User Details

If you are logged in to the API Developer Portal, your login name is displayed next to the Logout button. Click on the name to access your personal user details.

The information is displayed in read-only mode.

If you want to change your user preferences, click the Edit User Preferences button.

Notifications

This additional functionality can be found next to the Login/Logout button in the right upper corner. It informs you about important events in API Management and the API Developer Portal. Refer to Notifications for detailed information.

Multiexcerpt include

SpaceWithExcerpt	INTERNAL
MultiExcerptName	info_enable_mail_notifications
PageWithExcerpt	INTERNAL:_api_excerpts

APIs

The APIs are displayed as tiles. Displayed are name and description saved during the creation of the API in API Management (refer to Creating an API for details).

The API version label is displayed if more than one version of the API are available.

In addition to that, two buttons are shown:

API Documentation: This button is displayed, if documentation for an API is available.
Learn more: This button directs the user to the details page of the API.

API Documentation

Multiexcerpt include

SpaceWithExcerpt	INTERNAL
MultiExcerptName	api_documentation_button
PageWithExcerpt	INTERNAL:_api_excerpts

Multiexcerpt include

SpaceWithExcerpt	INTERNAL
MultiExcerptName	testing_api_with_swagger
PageWithExcerpt	INTERNAL:_api_excerpts

Anchor
details_page
details_page
API Details Page (Private API)

On the details page of a Private API, users can find further information about the API such as an extended description, the available plans and if a plan requires approval.

If a user wants to subscribe for an API, he has to use the Sign Up button in the plan he wants to register for (refer to Developer Access to APIs for details).

Multiexcerpt include

SpaceWithExcerpt	INTERNAL
MultiExcerptName	api_doc_and_definition
PageWithExcerpt	INTERNAL:_api_excerpts

Multiexcerpt include

SpaceWithExcerpt	INTERNAL
MultiExcerptName	api_version_label
PageWithExcerpt	INTERNAL:_api_excerpts

API Details Page (Public API)

Multiexcerpt include

SpaceWithExcerpt	INTERNAL
MultiExcerptName	details_page_public
PageWithExcerpt	INTERNAL:_api_excerpts

Multiexcerpt include

SpaceWithExcerpt	INTERNAL
MultiExcerptName	api_doc_and_definition
PageWithExcerpt	INTERNAL:_api_excerpts

Changing the User Preferences

You can edit some of your user preferences in the external identity management.

Click the Edit User Preferences button to access it.

In the identity management (Keycloak), you have several options:

You can edit your personal information.
You can change your password.
The applications you are currently logged in to are displayed here.

Editing the Personal Details

Open the Personal Info menu to adapt:

your email address
your name
your preferred display language

Tip

title	Expert Advice

It is possible to add more languages to the configuration fo your API developer Portal. See Administration Guide > Customizing PAS for further information.

Click Save to apply your changes.

Changing the Password

If you want to change your password, open the Account Security menu and the Signing in submenu.

Click on button Update.

You will then be redirected to the Scheer PAS login page.

Use the link Forgot Password? to receive an email with a link to reset your password.

Tip
The whole process is explained in detail in the Getting Started With Scheer PAS guide.

Other User Information

Below the user preferences you will find two more tabs:

Identity Management: Provides internal information that may be needed when you contact our support team with API Developer Portal issues.
Scheer PAS API Management: Provides internal information about the API Management permissions of your user.

The API Management version you are currently working with is displayed in the footer of the API Developer Portal.

Panel

title	On this Page:

Table of Contents

Panel

title	Related Pages:

Otp

Floating	false

rp

rde

Panel

title	Related Documentation:

Home

Page tree

Versions Compared

Old Version 1

New Version Current

Key

Contents of the API Developer Portal