JasperReports Server is a component of both a community project and commercial offerings. Each integrates the standard features such as security, scheduling, a web services interface, and much more for running and sharing reports. This guide discusses all editions. Sections of the guide that apply only to the commercial editions are indicated with a special note.
This document describes the JasperReports Server’s web services that allow client applications to interact with the server programmatically.
There are three different Application Programming Interfaces (APIs) using two different protocols:
|•||REST (REpresentational State Transfer) – A RESTful interface depends on the standard methods provided by HTTP: GET, PUT, POST, and DELETE. The API sends and receives resource descriptors that are the object or result of the operation.|
|•||REST (v1) – The original REST API supports only XML descriptors, and it is not as efficient or simple to use. This interface is deprecated: it is still supported but is not enhanced with new features. The REST (v1) API may be unsupported and later removed in future versions of the server.|
|•||SOAP (Simple Object Access Protocol) – The SOAP interface sends and receives XML documents to describe operations, process requests and provide results. The SOAP interface is no longer supported nor maintained, but it is still included in JasperReports Server for backwards compatibility. The SOAP API may be removed in future versions of the server.|
This chapter contains the following sections:
|•||REST Web Services Overview|
|•||REST Server Information|
|•||SOAP Web Services Overview|
|•||Syntax of resourceDescriptor|