REST API for user access to E-CRIS data

The REST user requests for access to E-CRIS data are available at the general address:

https://cris.cobiss.net/{system}/{language}/service

For the Slovenian system (SICRIS), the following address is used when addressing requests:

https://cris.cobiss.net/e-cris/mk/mk/service

The main link must be updated with the addresses for individual methods and search parameters, as is described below, in order to be able to access the available authorisation methods and access to E-CRIS entity data.

Authorisation

ZAuthorisation is required to access the E-CRIS data. It is performed for every claim based on the acquired JWT token. The valid toked is acquired based on the initial REST claim with a valid username and password.

The JWT token is acquired using the POST method getjwt:

POST https://cris.cobiss.net/e-cris/mk/mk/service/getjwt

In the POST claim body for acquiring the JWT token, the parameters username and password must be included:

{

"username": "user_name",

"password": "valid_password"

}

The result of a request with successful authorisation using a valid username and password in the JSON format:

{

"jwt": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzeXN0ZW0iOiJzaSIsInNleCI6IkYiLCJzaWduZWRJbiI6dHJ1ZSwidXNySWQiOjQ1OTcsImVudGl0eUlkIjo0NzcwMiwidG9rZW5UeXBlIjoiU0hPUlQiLCJ0eXBlIjoiU0hPUlQiLCJ1c2VyTmFtZSI6IlJTUi5TSS40MDQ5MyIsImVudGl0eSI6IlJlc2VhcmNoZXIiLCJpc3MiOiJpenVtLnNpIiwiaWF0IjoxNjUyNzc1NTM2LCJleHAiOjE2NTI4NjE5MzZ9.Oh2ESevUmhHE0G1dGIzKNZZ6F4Nt2_2KZNfpSo5zaCI",

"statusKey": "You have logged in successfully",

"status": "OK"

}

UIn the case of an incorrect claim or an error, the following responses are possible:

For claims for all further methods for accessing E-CRIS entity data, a valid JWT token must be included. If there is no token or it is invalid, the server retrieves error 401 (Unauthorized).

The JWT token is only valid for 24 hours!

Claims for accessing E-CRIS entity data

To access the data available in the E-CRIS system, the retrieval of methods related to each system entity is used.

The available methods for accessing data on the individual entities are used in the same way as demonstrated on the example of claims for access to data on projects and programmes:

GET https://cris.cobiss.net/e-cris/mk/mk/service/project/search

Result of a performed GET claim:

{"frame":"MST","id":18090,"stat":"REG","statadm":"UPD","statdate":"2020-04-17T09:15:00","type":"PRG","classificationDescr":["Kmetijske rastline","Rastlinska produkcija in predelava","Biotehnika"],"counter":"5828","field":"03","science":"4","subfield":"01","avfte":4982,"code":"P4-0085","codeContract":"0085","codeProgramme":"P","codeScience":"4","enddate":"2025-12-31","firstName":"Domen","lastName":"Leštan","mstrank":"D","name":"Agroekosistemi","resaercherFullName":"dr. Domen Leštan","rsrCode":"08259","rsrid":6345,"rsrttl":"DOD","startdate":"2020-01-01","title":"dr.","uplimit":0}, ....