Software AG Products 10.11 | Using Developer Portal | Developer Portal REST APIs | Overview
 
Overview
The headless architecture feature of Developer Portal equips you with the APIs that you would require to build an application with the Developer Portal functionality.
The REST APIs that come along with the Developer Portal installation allow you to perform all functions that you can accomplish through the application's user interface.
Developer Portal REST APIs are located at SAGInstallDir\DeveloperPortal\developers\openapis.
Authentication to use Developer Portal REST APIs
The authentication method applicable for the Developer Portal REST APIs is HTTP Basic authentication.
Access privileges based authorization
The availability of API resources is based on the user privilege. Typically, users who have the API Administrator privilege have access to all APIs, whereas, the users who have any of the API Provider and API Consumer privileges have limited access of API resources.
REST APIs URI format
Developer Portal allows you to access the API resources using URI paths. The REST call URI must be specified with the required method in the format shown below:
Possible response messages
The following table lists the possible response messages and what they indicate:
Response message
Description
200 - OK
Indicates the request sent and response received successfully.
201 - Created
Indicates that the request is fulfilled, resulting in the creation of a new resource.
400 - Bad request
Indicates that a parameter is missing in the request due to which it could not be processed.
401 - Unauthorized
Indicates authorization problem.
403 - Forbidden
Indicates that there is no permission to the requested resource.
404 - Not found
Indicates that the requested resource does not exist.
500 - Internal server error
Indicates that an unexpected condition is encountered and no more specific message is suitable.
List of APIs
The REST APIs allow you to perform the following:
* Viewing analytics.
* Managing APIs .
* Managing applications .
* Managing approvals .
* Managing backup and restore .
* Managing comments.
* Managing communities
* Managing configurations .
* Viewing Developer Portal audit events.
* Viewing Developer Portal health.
* Managing notifications .
* Getting OAuth token.
* Managing packages.
* Managing plans.
* Managing providers.
* Performing search.
* Managing teams.
* Managing topics.
* Managing application and subscription requests.
* Managing users.
* Managing webhooks.