Product Information
SAP API Management – Engage with your Developer community on the brand-new Developer Portal
Introduction
Application Developers, who consume the APIs that you own, play a very important role in the success of your API Program. Attracting this developer community, helping them discover the right API for their apps and keeping them interested in your APIs is a key objective for you. The Developer Portal is the platform to conduct this engagement. Right from on-boarding developers to giving them an option to search, try and get access to the APIs – everything can be done on the Developer Portal.
With the latest release, we have provided a new look to the Developer Portal to improve the developer experience. As the administrators of Developer Portal, you will see additional capabilities to customize the site according to your branding requirements.
The following sections will give you an overview of the capabilities on the Developer Portal.
Customization of the Developer Portal
Developer portal is the face of your organization to the developer community. Hence, we give you the capability to reflect your organization’s branding on the site. With the current release, administrators can upload the company logo which will appear in the site always. With the subsequent releases we will also allow you to choose color schemes.
Apart from this, you can also customize the site Name & Description to give out the right kind of details to it’s users.
This will apply the changes in Home page.
In case you need to bring in your own links in the site, you can do so by configuring them in the Reference links section. This is very useful if you need to call out Terms of Use, Copyright and other Legal information. It can also be used to let users navigate into specific Help documentation, Community or Blog links.
This will update the Footer with the new links.
Note : You need to have the role AuthGroup.Site.Admin to perform the above customization.
Discovery of API Products
The Home page is the place where all the API Products from your company get listed. It has a search field to find API Products by title. It also allows you to sort the API Products in different orders. The API Products are displayed as tiles holding the description (for easy understanding), publish date (to indicate freshness of the API Product) and number of APIs (to indicate size) information.
Once you click on any of the API Products, you will see more information about it – like the APIs that are part of this product, Rate plan information (if any) along with other generic attributes.
To control the visibility of API Products for different Application developer groups and to allow subscriptions selectively follow the blog here.
Viewing and Trying out APIs
Once you click on any of the APIs in the Product, you will see the API resources rendered in OpenAPI format. You can use it to understand more about the provided functionality.
Subscription to an API Product
On the API Product, you have the option to create a new subscription or add the product to an existing subscription. Having a subscription (application) is a prerequisite to consume the APIs productively.
Subscriptions, Cost and Usage Analytics
There is a dedicated page ‘My Workspace’ where as application developers you will see all your subscriptions (applications) together with the cost you have incurred and analytics for the APIs you have consumed. This could be the go-to page for Application developers to keep track of their APIs’ usage and performance.
Clicking on any of the applications will reveal the Application key & secret and allows you to regenerate the same. You can also see the Analytics data corresponding to the selected application on the same page!
Test Console
There is a flexible test console that is available for testing the APIs by providing the necessary credentials, header & query parameters.
Developer On-boarding
As API owners, you will put up your Developer Portal and invite the Application developers to get on-board and use your APIs. When they launch the site, they see a simple registration page that they can fill in and request access. The request reaches the Administrator via mail. As an Administrator, you can approve the requests. Administrators can also revoke access for Developers under certain circumstances. All of this is performed in the Manage Users section.
Conclusion
The latest Developer Portal provides a new experience for the Application Developers and Administrators to Discover & Consume the APIs. It also has the ability to be customized as per your organization’s branding requirement. You can visit our official documentation here for further details. We hope these changes have a positive impact on your API journey. Feel free to share your feedback & comments.
P.S : In order to let you plan the transition, we have provided a link to the Classic Design in the site. We will remove the link in the coming weeks.
Thank you Shruthi. What is the dimension of the company logo that is supported ? If i upload my company logo, it is getting resized automatically without maintaining aspects.
Regards,
Parag.
Hi Parag
Most of the standard logo sizes should be supported like 250px x 150px , 350px x 75px, 400px x 100px. What is the size of your logo?
Thanks
Shruthi
190px x 39 px
Regards, Parag
Hello Parag
We have provided a resolution to retain the aspect ratio in case we need to resize. Kindly check back on the application by Apr 15th
Thanks
Shruthi
Thank you very much, works now.
Regards, Parag.
Hi
Is it possible to disable the "Test console" all together? As well as "My workspace"?
We don't have the need for it, neither the interest to make the necessary implementation effort to make them functional.
Cheers
/Kristoffer
Hi Kristoffer
Can you tell me more about your usecase? What would your developers do on the Dev portal if they can just discover the products?
Thanks
Shruthi
Hi again
So for us, the developer portal right now is a only a way to let the third party providers, the consumers of our APIs, try out the swagger definitions against the Sandbox without any extra tool such as Postman.
Hence, the features of Test console and My Workspace appears as noise instead of features. Especially as we, at this point, do not support the content and functions of those features.
Cheers
/Kristoffer
Hi
This is not configurable since almost all the usecases we have encountered require not just a try-out but also subscription and actual consumption of APIs. But we could consider providing this as a setting to the admin for customization. Could you provide me your Organization's name so that we know our customer ? :).
Thanks
Shruthi
Hello Shruthi,
I need to connect my WordPress form with SAP Business One CRM. I want that when user successfully submit the form it will be automatically created as a lead in my CRM with the source to know from where user has come like facebook, linkedIn etc.
Can I use this API https://api.sap.com/api/lead/resource
Please give me a solution. I am new in SAP and I really need this urgently.
Please help.
Thanks
Ramya
Dear Experts,
Can you please confirm if s-user (associated with mail id) is mandatory for developer portal access?
It is possible that developer portal access can be requested by several external partners with their company mail id's (without any s-user).
Can they all send registration request to the developer portal?
How do they(which user creds) even login to request registration? How does the validation happen?
Please explain how such scenarios are handled w.r.t SCP API Management
Many Thanks ,
Ruchita
Hello Rachita, I am facing the same problem. Did you get a solution for this ?
Hello shruthi,
I get issue while accessing analytics from Developer portal workspace. Can you please provide your inputs.
An error occurred while fetching 'Analytics' details. For further assistance, please contact support.