WOCAT » QCAT

h1. API / Web Services Definition 

h2. 1. General Requirements

h3.  1.1. *The API is based on RESTful web services*

h3. 1.2. *No authentification is needed to query/download published data*

h3. 1.3. *The API has a version*

This can either be done through a parameter or a path. Preferably part of the path to force version idication.

h3. 1.4. *Output/Answer*

The Output formats should selectable between JSON,XML and CSV with JSON as default.

h2. 2. Configuration queries

h3. 2.1. All configurations

* *Request* 

<pre>

GET .../configurations

</pre>

* *Parameters:*

* *Returns:* 

** List of all configurations and all  their versions

* *Answer items:*

** Configuration name (identifier)

** Configuration version

** Date of creation / last update

** (Short description ?)

h3. 2.2. Single configuration

* *Returns:*

** A single configuration 

* *Items*

h3.