API

The API is an experimental feature. It can be temporarily suspended or revoked at any time. The format and calling conventions can change in the future.

How to use API to access our tools.

Currently available tools:

Get a key

First, get an access key, by accessing the https://www.juls.savba.sk/api/get_key/ URL, with two parameters (both POST and GET methods are supported; in POST, you can use either www-urlencoded or JSON protocol). You can obtain only a few keys per hour, and the key should be valid for at least 24 hours. When asking for the key, please provide these fields:

  • name – your (real) name
  • email – your e-mail
  • institution – your institution (optional)
  • comment – anything additional you want to say

Success is indicated by the 200 OK http response code, the key is written in the body of the response. Failure by a 4xx or 5xx error code, together with a short description of the error.

Example when using the GET method:

https://www.juls.savba.sk/api/get_key/?name=YOUR_NAME&email=your@email.tld&institution=YOUR_INSTITUTION&comment=Anything+you+want+to+say