Definition of API
Application Programming Interface (API) is an interface that a software program implements to allow other software to interact with it. Similarly, the software might also implement a user interface for users.
Applications, libraries, and operating systems implement APIs to define how other software can call or request services from them. An API determines the vocabulary and calling conventions a programmer should employ to use such services. It may include specifications for routines, data structures, object classes, and protocols used to communicate between the consumer and implementer of the API.
About the Asite API
Asite API is an interface that allows other software applications to interact with the services and data stored within the Asite Business Operating System (ABOS) platform. Asite API supports both REST-based and SOAP-based interfaces.
REST-Based API: REST (representational state transfer) is an approach for getting information content from a website by reading a designated web page containing an XML (Extensible Markup Language) file that describes and includes the desired content.
SOAP-based API: SOAP is a protocol for accessing a Web Service. SOAP is a simple XML-based protocol that lets applications exchange information over HTTP.
SOAP, defined as Simple Object Access Protocol, is a protocol specification for exchanging structured information to implement Web Services in computer networks. It relies on Extensible Markup Language (XML) for its message format, and also on other application Layer protocols, most notably Remote Procedure Call (RPC) and Hypertext Transfer Protocol (HTTP), for message negotiation and transmission.
This means that you can send an HTTP GET or POST to call exposed methods and receive an XML document in return.
The Asite API defines the vocabulary and calling conventions the programmer should employ to use the services. The Asite API consists of a set of callable methods, and API endpoints and expects all data to be UTF-8 encoded. The Asite API thus enables combining multiple services into new applications or mashups.
The REST-based API uses the RESTEasy framework. RESTEasy is a JBoss project that provides a framework for building RESTful Web Services and RESTful Java applications. It is a fully certified and portable implementation of the JAX-RS (Java API for RESTful Web Services) specification.
The Asite Portlet container is based on portlet specification, an open standard. The Asite Platform allows our users and partners to develop their mashups and incorporate them into their personalized views or share them with colleagues, the supply chain, and beyond. The Asite Portlet enables you to bring the content from your SharePoint web part into the Asite portal homepage in real time. You can pull supply chain data from the Asite platform into your SharePoint web parts. Asite Portlet container runs on top of the Liferay Portal which is JSR-168 and JSR-286 (both comply with portlet specification).
Asite AppBuilder is a development framework that allows you to build Forms within the Asite platform. The framework is based on the Microsoft InfoPath’s '.XSN' format. It will enable you to use a WYSIWYG design interface to create the form’s Interfaces and data points (effectively database fields are called Data Sources) for the form. Advanced functionality can also be developed using JScript code. Forms can also be designed with multiple forms that work together to create a larger application. These Apps use data connections between the forms (using the SOAP-based API) to allow the forms within the App to call data between themselves.
Asite API Services are designed to support the requirements of multiple entities, namely:
Individual users,
Customer Organisations,
Third-party systems, and
Public data access
API framework:
Is independent of Client Languages used in their applications;
Is independent of the Client Web Browser and is scalable for Component interactions;
Supports independent deployment of components and field selectors;
Immediately integrates with any applications that use Asite API;
Manage and respect data validations, workflow, and security of information;
Requires authentication for user credentials. This is necessary for any request received in the Asite Platform or sent from the Asite Platform.
Can receive HTTP requests and send back XML data to Client Applications accessing data from internal and external applications;
It is flexible for users to specify a list of fields that can be sent with the request.
Click here for detailed help on Asite API Services.