Creating an Enterprise Page on SAP API Business Hub
After completing this lesson, you will be able to:After completing this lesson, you will be able to:
- Create an enterprise page on SAP Business Hub
Create an Enterprise Page on SAP API Business Hub
Scenario
You want to release the previously created API in a centrally accessible place within your organization. To do this, you will create an API Business Hub Enterprise page with the released APIs.
Task Flow
In this exercise, you will perform the following steps:
- Create an application
- Find and save the API key
- Create a Slack channel
- Find and save the channel ID
- Save the URL for sending messages
Prerequisites
- You have created a functioning API in the API Management Portal based on Slack
- You have created a product
Create an Enterprise Page on SAP API Business Hub
Task 1: Create an Enterprise Page on SAP API Business Hub
Steps
Create an application in API Business Hub Enterprise.
Navigate to the API Business Hub Enterprise page by selecting API Business Hub Enterprise on the top-right of the API Portal home screen.
On the API Business Hub Enterprise start screen, you will find a tile with your created product, Supplier Slack.
Use the menu to navigate to the Manage page.
Select Registered Users in the Manage Users tile.
Enter an e-mail address in the administrator area and acknowledge by selecting the hook.
Select the + icon in the Registered Users area.
On the next screen enter the following data:
Field | Value |
---|
User ID | The user ID or email address of your trial account |
First Name and Last Name | Choose any name |
Email ID | The email address of your trial account |
Assigned Roles | Assign all available roles |
Reason | Choose any reason |
Country/Region | Choose any country |
Select Save.
The result should look like the following:
Navigate to My Workspace using the menu on top of the screen.
Select the + button to create a new application.
Insert a meaningful name, for example, Supplier Slack App and select the + icon to add a product.
Choose Supplier Slack and choose OK.
Save the created application by selecting Save.
On the resulting page, you will find the Application Key, which is required for all calls. Copy and save it for later use.
Find and save the Application Key.
To find and save an regenerate the Application Key to access this application, navigate to My Workspace and choose your application from the list, for example, Supplier Slack App.
Select the application entry and find the Application Key.
Save it for later use within the Cloud Integration.
Create a Slack channel.
In a later step, you want to send a notification to a Slack channel. Therefore, you need to create one manually.
Navigate to Home and select your API tile, for example, Supplier Slack.
Select Channels → POST /channels and choose the Try out button.
Insert the previously saved API Key into the Authorization header field.
Insert in the body object > name: purchaseorder<current date> (for example, purchaseorder031021) and choose Execute .
HintThe name of the channel has to be in lowercase notation.
Find and save the channel ID.
If the request is successful, you retrieve a response containing the created channel. Look for the ID of your channel in the response message. Save it.
After that, you can check again with a GET request. To do this, select the Slack tile to open the API. Navigate to channels → GET/channels{channelId}. Enter the API key and channel ID in the requested fields.
Copy and save the required URLs for later use.
Navigate to channels → POST /channels and choose the Try outbutton.
Insert the previously saved API Key in the Authorization header field and the channel ID in the channelId field.
Insert a test message into the "text": property in the body, for example, check031021. Then, select Execute.
Copy the Request URL and save it for later use.
Now you can open your workspace in Slack to find your newly created channel with the message.
Summary:
You have deployed a working API in API Business Hub Enterprise. The API can now be used for communication in the next steps.
Save progress to your learning plan by logging in or creating an account
Login or Register