REST API Overview
This document outlines the design of a REST-based API for Aspose Cloud. It also covers the structure of REST URLs, as well as specific behavior linked to the API such as Authentication, Request Queuing, and Storage. The Aspose Cloud APIs will give developers access to all the key functions of the downloadable Aspose components through a Software as a Service hosted model.
There will be 3 sub-components within the API design (although these are largely transparent to the end-user);
- Platform - it covers elements of the Aspose Cloud platform. These elements are not directly linked to file format manipulation, such as Storage, Authentication, Queuing, etc;
- Common - it covers the common elements of the API which are shared by all products;
- Product - it covers product-specific areas for each product;
The Aspose Cloud API is a REST-based API for wide usability on the web across platforms. By default, the REST API returns XML formatted responses, but it is possible to get the response in JSON format by setting Content-Type to application/json. Accompanying the REST API will be Client SDKs for all major development platforms which will provide client libraries to make it very easy for developers to code against the Aspose Cloud APIs.
Aspose Cloud API requests are made by sending a correctly constructed HTTP requests to the following address, with arguments being generally submitted as HTTP get or post arguments and data files being sent as HTTP post method where necessary.
Each version beginning with 3.0 or 4.0 will have its number as a part of the URL. So the next URLs are used for the first version:
Each product uses its own URL route (key word) to separate its interface:
- Words uses words route;
- Cells uses cells route;
- Pdf uses pdf route;
- Slides uses slides route;
- Email uses email route;
- BarCode uses barcode route;
- Imaging uses imaging route;
- Tasks uses tasks route;
- OCR uses ocr route;
- OMR uses omr route;
Each user’s application has its own root folder at the server, but any number of subfolders at different levels can be created as well. File storage considers folders as resources and gets the folder or file path as a part of URL:
where the file relative to application root folder path is folder/subfolder/subsubfolder/file.txt. See e.g. Folder for additional details.
While product services get the folder path as a query string folder parameter.
Within the API we will have Resources (each identified by a URI) and Operations (as much as possible covered by the 4 HTTP Methods: GET, POST, PUT and DELETE) which can be applied to those resources.
Default ‘empty’ request https://api.aspose.cloud/v3.0 redirects to service start page with a link to some helpful examples. Please check following articles for information regarding Request and Response Format and how to authenticate Aspose Cloud API request.