REST Services

This white paper contains information about the REST‑based web services that Jade provides.

A web service usually uses HTTP to exchange data. Unlike a web application, which is typically HTML over HTTP, a web service uses HTTP with a file format specialized for machine-readability; for example, Extensible Markup Language (XML) or JavaScript Object Notation (JSON). When a client sends a request in XML or JSON, the server responds with a response in the same format.

A Representational State Transfer (REST) API is a type of web service. A REST API differs from the older SOAP‑based web services in the way it is intended to be used. By using REST, the API tends to be lightweight and embraces HTTP. For example, a REST API leverages HTTP methods to present the actions a user would like to perform, with the application entities becoming resources on which these HTTP methods can act.