POSTs of data arrays and data responses are JSON documents. It is recommended to use an existing JSON library implementation for the language you are programming in (see http://www.json.org).
For JSON serialization/deserialization the server uses the JACKSON implementation for JSON, thus one-element-arrays are put into brackets [ ] as well.
General values received from the server (ID, timestamp of transmission/creation) are returned as attributes (@-Notation).
If there is an error the server will return only standard authorization HTTP errors (i.e. 401 Unauthorized, 405 Method Not Allowed etc.) and a standard error for all other errors (500 Internal Server Error). Internal error messages are blocked by the application and not revealed to the user or the developer.
Some of the requests have to use OAuth. This is accomplished by generating an OAuthAuthorization Header which MUST be placed in the Authorization header of the HTTP request (similar to a HTTP basic authentication header).
VitaDock Online Responses
Unauthorized Access Tokens/Secrets, Access Tokens/Secrets and Device Tokens/Secrets parameters are returned by VitaDock Online in the HTTP response body. The parameter names and values are first encoded as per Parameter Encoding, and concatenated with the ‘&’ character (ASCII code 38) as defined in [RFC3986, section 2.1] .
The return will always be in this format: oauth_token=<token>&oauth_token_secret=<secret>