REST API за приступ корисника подацима у CRIS систему

Кориснички REST захтеви за приступ подацима у CRIS систему доступни преко опште адресе:

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

За словенски CRIS систем приликом упућивања захтева користи се адреса:

https://cris.cobiss.net/e-cris/rs/sr/service

Основни линк за приступ расположивим методама за ауторизацију и приступ подацима CRIS ентитета треба допунити упућивањем појединачних метода и параметара за претраживање, као што је описано у наставку.

Ауторизација

За приступ CRIS подацима неопходна је ауторизација која се изводи при сваком позивању на основу добијеног ЈWТ жетона. Важећи жетон се добија на основу иницијалног REST позива са важећим корисничким именом и лозинком.

ЈWТ жетон се добија извођењем POST позива методе getjwt:

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

У POST позив за добијање ЈWТ жетона треба укључити параметре username и password:

{

"username": "корисничко_име",

"password": "важећа_лозинка"

}

Резултат захтева при успешној ауторизацији с важећим корисничким именом и лозинком у JSON формату:

{

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

"statusKey": "Успешно сте се пријавили",

"status": "OK"

}

У случају неправилног позива или грешке могући су следећи одговори:

Код позива свих следећих метода за приступ подацима CRIS ентитета треба укључити важећи ЈWТ жетон. Ако жетон не постоји или није правилан, сервер враћа грешку 401 (Unauthorized).

ЈWТ жетон важи 24 часа!

Позиви за приступ подацима CRIS ентитета

Подацима који су расположиви у CRIS систему приступамо помоћу позива метода које се односе на појединачне ентитете система.

Расположиве методе за приступ подацима о појединачним ентитетима користе се на исти начин као што је приказано на примеру позива за приступ подацима о пројектима и програмима:

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

Rezultat izvedenog poziva GET:

{"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}, ....