SyCes API

Our SyCes-API uses the JSON-RPC protocol, version 2.0.

JSON-RPC (JavaScript Object Notation Remote Procedure Call) is a simple remote procedure call protocol encoded in JSON.

You must call the API via HTTPS.

Clients need to send a request object to our server with the following properties:

• jsonrpc: a string containing the JSON RPC version, currently “2.0”
• method: a string with the name of the method to be invoked
• params: an array of objects to be passed as parameters to the defined method
• id: a unique string to match the response with the request that it is replying to

(could be a combination of sessionid + sequence)

the response object contains the following properties

• jsonrpc: a string containing the JSON RPC version, currently “2.0”
• result: If no error occurred, the data returned by the invoked method. Else no result is sent.
• error: if there was an error,a specified error code, otherwise no error is sent.
• id: the id of the request it is responding to

You need to a valid sessionid for any api call. It can be retrieved by calling the authenticate-method with your username and password.

request { “jsonrpc”: “2.0”, “method”: “authenticateByRealm”, “params”: {“api_key”: “231af78…”, “realm”: “clientdomain.de”}, “id”: 1}
result for valid credentials { “jsonrpc”: “2.0”, “result”: “0252rkcf5jm2rop8rtbnno4og5”, “id”: 1}
result for invalid credentials { “jsonrpc”: “2.0”, “code”: 20, “error”: {“message”: “Invalid credentials.”}, “id”: 1}