Кориснички 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"
}
У случају неправилног позива или грешке могући су следећи одговори:
Статус | Значење |
---|---|
401 Unauthorized | Унет погрешан евиденциони број, односно е-адреса или погрешна лозинка |
404 Not found | Подаци за задати захтев за претраживање не постоје |
500 Internal_server_error | Подацима се не може приступити услед погрешно наведених параметара позива |
501 Not Extended | У REST позиву није наведена метода |
Код позива свих следећих метода за приступ подацима CRIS ентитета треба укључити важећи ЈWТ жетон. Ако жетон не постоји или није правилан, сервер враћа грешку 401 (Unauthorized).
ЈWТ жетон важи 24 часа!
Позиви за приступ подацима CRIS ентитета
Подацима који су расположиви у CRIS систему приступамо помоћу позива метода које се односе на појединачне ентитете система.
CRIS ентитет | REST позив |
---|---|
Истраживачи | /researcher/search /researcher/{id} |
Пројекти и програми | /project/search /project/{id} |
Организације | /organization/search /organization/{id} |
Групе | /group/search /group/{id} |
Библиографије истраживача | /biblio/researcher/{arrsCode} |
Расположиве методе за приступ подацима о појединачним ентитетима користе се на исти начин као што је приказано на примеру позива за приступ подацима о пројектима и програмима:
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}, ....
Примери задавања REST позива укључивањем параметара и приступа подацима на основу ID | Резултат |
---|---|
... /project/search | Основни упит враћа првих 10 записа са списка пројеката и програма |
... /project/search?query=*&limit=ALL | Сви записи са списка пројеката и програма |
... /project/search?query=matematika&limit=5 | Првих пет записа са списка пројеката и програма |
... /project/{id} (npr: ... /project/18090 | Подаци о пројекту са cerifId=18090 |
... /researcher/47702 | Општи подаци о истраживачу са CRIS id=47702 |
... /researcher/search?query=35460 | Шири скуп података о истраживачу са шифром 35460 на основу изведеног упита за претраживање. |
... /researcher/search?query=&frascati=30000limit=20 | Подаци о првих 20 истраживача из области медицине |
... /organization/search?query=AdriaData | Подаци о организацијама с називом AdriaData |
... /group/search?query=A-LIFE | Подаци групе с називом A-LIFE |
... /project/search?query=L1&limit=5 | Испис података о пет пројеката са списка пројеката који су уписани у CRIS систем и који у делу евиденционог броја садрже низ L1. |
... /project/search?query=L1&offset=10&limit=5 | Ако резултате желимо да испишемо по страницама, додамо параметар offset. Код резултата из примера у испису прескаче се првих 10 пројеката и исписује се следећих 5. |
... /biblio/researcher/50420 | Списак садржи попис COBISS.SR-ID за истраживача с обзиром на шифру из евиденције. |