The architecture of BizTalk360 has four main components -
- Web interface layer
- REST API Layer
- BizTalk360 Monitoring Service
- BizTalk360 Database
There may be occasions when organizations face the need to show information from the BizTalk environment on external applications such as SharePoint, internal applications, internal dashboards, and so on. To achieve this, organizations are forced to write their own piece of code that will fetch the information from the BizTalk environment and display them in the external applications. This is definitely a time consuming task as it involves effort to write custom code and intensive testing to see if the code returns the exact intended result.
With API Documentation capability of BizTalk360, we have exposed over 230 REST services (APIs) that have the capability to retrieve the requested information from the BizTalk server environment. The APIs are defined as Swagger files which means that you have the ability to execute them inline to see if the result is what is intended. For example, you may want to display the list of BizTalk Applications or the performance of the BizTalk server (such as CPU, Memory, etc) in a custom dashboard application within your organization. With BizTalk360 API Documentation, it is very easy for you to consume the API and retrieve the information from the BizTalk server environment. It not only ends with these. You can access pretty much any information like EDI, BAM, Artifact information, and so on from the BizTalk environment with the help of BizTalk360 APIs.
Work with BizTalk360 Directly Through the API Documentation Section
Another advantage of using the API Documentation capability within BizTalk360 is that you can still work with BizTalk360 though the API documentation section. If you are very comfortable working with HTTP GET/POST requests, all it takes is to take the example JSON from the GET/POST API services and replace them with the appropriate values as in your environment.
Retrieve information about the BizTalk environment (using HTTP GET service)
Lets say, you want to retrieve the list of BizTalk applications in your environment with all the appropriate details. All you need to do is to navigate to the BizTalkGroupService (group services) and choose the Services.REST/BizTalkGroupService.svc/GetBizTalkApplicationsList from the list of APIs. All you need to retrieve the application information is the "environment id" parameter. Copy the environment id from the Environment Details section on the BizTalk360 API's page and paste it in the "parameters" section of the HTTP GET service. In one click (Try it out! button), you will see all the details of the BizTalk applications in the selected environment. Similarly, you can retrieve the information of all the BizTalk applications across multiple BizTalk environments in the organization through the API documentation section of BizTalk360.
To know more about the HTTP GET service(s) in detail and how to retrieve the information, please refer this article.
Modify information in the BizTalk environment or BizTalk360 database (using HTTP POST service)
In addition to retrieving the information from the BizTalk environment, with BizTalk360 API documentation, administrators have the capability to modify the information in the BizTalk environment or the BizTalk360 database with the help of HTTP POST services. Lets say, as a BizTalk360 administrator, you want to add a new user with Super User rights in BizTalk360. With the Services.REST/AdminService.svc/MaintainAdminUser service, you can easily add/modify a super user in BizTalk360. All you need to do is to copy the example JSON that is provided in the API documentation section and modify the values. In one click (Try it out!), you will see the response if the service call was successful or a failure. If the service call was successful, you will notice that a new user would have been added with Super User capabilities under User Access Policy section in BizTalk360.
To know more about the POST service(s) in detail and how to add/modify information in the BizTalk environment/BizTalk360 database, please refer this article.