Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Your created APIs are available for your customers and their developers within the API Developer Portal.
Contents of the API Developer Portal
The API Developer Portal is fully customizable, you can determine its contents yourself (refer to Customizing the API Developer Portal for details). The default template contains the following content:
HomeHome 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 start page (refer to API Settings > Settings for details).
| |||||||||||||||||||||||
MarketplaceThe Marketplace is where all published APIs are displayed. Developers can use the filter to search the whole variety of your APIs. | |||||||||||||||||||||||
My ClientsIn 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 TabsYou can customize your API Developer Portal and add further tabs, for example a tab Support to connect your own customer support service desk.
| |||||||||||||||||||||||
User DetailsIf you are logged in to the API Developer Portal, your login name is displayed on top right next to Logout. Click on your login name to access your personal user details. The information is displayed in read-only mode. If you want to change your user preferences, click Edit User Preferences. | |||||||||||||||||||||||
NotificationsThis additional functionality can be found next to the Login/Logout in the right upper corner. It informs you about important events in API Management and the API Developer Portal. Refer to Notifications for further details.
| |||||||||||||||||||||||
APIsThe APIs are displayed as tiles. Displayed are name and description saved during the creation of the API (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, you have two options:
| |||||||||||||||||||||||
API DocumentationClick API Documentation to access the Swagger UI where you can test the API (refer to Testing APIs for details).
| |||||||||||||||||||||||
On the details page of a private API, you can find further information about the API such as an extended description, the available plans and if a plan requires approval. If you want to subscribe for an API, click Sign Up in the plan you want to register for (refer to Developer Access to APIs for details).
| |||||||||||||||||||||||
API Details Page (Public API)On the details page of a Public API, users can find further information about the API such as an extended description and the public endpoint.
|
Changing the User Preferences
You can edit some of your user preferences in the external identity management. Click Edit User Preferences to access it. | |
In the identity management (Keycloak), you have several options:
|
Editing the Personal Details
Open the Personal Info menu to adapt:
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 Update. | |||
You will then be redirected to the Scheer PAS login page. Use the link Forgot Password? and enter your username to receive an email with a link to reset your password.
|
Enabling Two-factor Authentication
If you want to enable the two-factor authentication, open the Account Security menu and the Signing in submenu. Click Set up autheticator application. | |
Follow the instructions that are displayed on the screen. |
Other User Information
Below the user preferences you will find two more tabs:
| |
The API Management version you are currently working with is displayed in the footer of the API Developer Portal. |
Panel | ||
---|---|---|
| ||
|
Panel | ||
---|---|---|
|
Otp | ||
---|---|---|
|