REST API za pristup korisnika podacima u CRIS sistemu

Korisnički REST zahtjevi za pristup podacima u CRIS sistemu dostupni preko opće adrese:

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

Za slovenski CRIS sistem prilikom upućivanja zahtjeva koristi se adresa:

https://cris.cobiss.net/e-cris/bh/bs/service

Osnovni link za pristup raspoloživim metodama za autorizaciju i pristup podacima CRIS entiteta treba dopuniti upućivanjem pojedinačnih metoda i parametara za pretraživanje, kao što je opisano u nastavku.

Autorizacija

Za pristup CRIS podacima neophodna je autorizacija koja se izvodi pri svakom pozivanju na osnovu dobijenog JWT žetona. Važeći žeton se dobija na osnovu inicijalnog REST poziva sa važećim korisničkim imenom i lozinkom.

JWT žeton se dobija izvođenjem POST poziva metode getjwt:

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

U POST poziv za dobijanje JWT žetona treba uključiti parametre username i password:

{

"username": "korisničko_ime",

"password": "važeća_lozinka"

}

Rezultat zahtjeva pri uspješnoj autorizaciji s važećim korisničkim imenom i lozinkom u JSON formatu:

{

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

"statusKey": "Uspješno ste se prijavili",

"status": "OK"

}

U slučaju nepravilnog poziva ili greške mogući su sljedeći odgovori:

Kod poziva svih sljedećih metoda za pristup podacima CRIS entiteta treba uključiti važeći JWT žeton. Ako žeton ne postoji ili nije pravilan, server vraća grešku 401 (Unauthorized).

JWT žeton važi 24 časa!

Pozivi za pristup podacima CRIS entiteta

Podacima koji su raspoloživi u CRIS sistemu pristupamo pomoću poziva metoda koje se odnose na pojedinačne entitete sistema.

Raspoložive metode za pristup podacima o pojedinačnim entitetima koriste se na isti način kao što je prikazano na primjeru poziva za pristup podacima o projektima i programima:

GET https://cris.cobiss.net/e-cris/bh/bs/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}, ....