Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

PopisResursa

Index (početni resurs)

Index je korjenski (root) resurs koji je ujedno i početni URL. Svi ostali URL-ovi se mogu mijenjati kroz vrijeme. Pristup svim ostalim URL-ovima zahtjeva autentifikaciju.

Pristup index resursu

Http metoda GET se koristi za pristup ovom resursu.

Struktura odgovora

...

_links

...

Object

...

Linkovi na ostale resurse.

Primjer odgovora

Code Block
{
  "_links" : {
    "znanstvenici" : {
      "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenici?page=1"
    },
    "znanstvenik-oib" : {
      "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenik/oib/{oib}",
      "templated" : true
    },
    "znanstvenik-maticni-broj" : {
      "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenik/maticni-broj/{maticnibroj}",
      "templated" : true
    },
    "profile" : {
      "href" : "http://croris.srce.hr:443/znanstvenici-api/dokumentacija"
    },
    "self" : {
      "href" : "https://croris.srce.hr/znanstvenici-api/"
    }
  }
}

Linkovi

...

znanstvenici

...

Link na osnovne podatke i popis svih znanstvenika u evidenciji.

...

znanstvenik-oib

...

Link na detaljnije podatke o danom znanstveniku kojima se pristupa pomoću oiba.

...

znanstvenik-maticni-broj

...

Link na detaljnije podatke o danom znanstveniku kojima se pristupa pomoću matičnog broja

...

self

...

Link na ovaj resurs.

...

profile

...

Link na dokumentaciju.

Znanstvenici

Link za popis svih znanstvenika u evidenciji i njihovi osnovni podaci.

Pristup znanstvenici resursu

Http metoda GET se koristi za pristup ovom resursu. Za prikaz znanstvenika koristi se paginacija, odnosno postoji obavezni parametar koji se mora proslijediti u upitu. Primjer urla je self link u danom primjeru odgovora.

Struktura odgovora

Svaka stranica prikazuje 1000 zapisa znanstvenika.

...

_embedded.znanstvenici

...

Array

...

Lista pojedinih znanstvenika u evidenciji s pripadnim linkovima.

...

_links

...

Object

...

Linkovi na ostale resurse.

Primjer odgovora

Code Block
{
  "_embedded" : {
    "znanstvenici" : [ {
      "spol" : "M",
      "jmbg" : "2339452353116",
      "oib" : "31027653304",
      "maticniBroj" : "255432",
      "email" : "doku@mentacija",
      "ime" : "Acija",
      "prezime" : "Dokument",
      "_links" : {
        "self" : {
          "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenik/maticni-broj/255432"
        },
        "znanstvenik-oib" : {
          "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenik/oib/31027653304"
        },
        "znanstvenik-maticni-broj" : {
          "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenik/maticni-broj/255432"
        }
      }
    }, {
      "spol" : "M",
      "jmbg" : "2339452353217",
      "oib" : "31027653305",
      "maticniBroj" : "255433",
      "email" : "dokumentacija@dokumentacija",
      "ime" : "Dokumentcija",
      "prezime" : "Dokumentcija",
      "_links" : {
        "self" : {
          "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenik/maticni-broj/255433"
        },
        "znanstvenik-oib" : {
          "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenik/oib/31027653305"
        },
        "znanstvenik-maticni-broj" : {
          "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenik/maticni-broj/255433"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenici?page=1"
    },
    "profile" : {
      "href" : "http://croris.srce.hr:443/znanstvenici-api/dokumentacija#resursi-znanstvenici"
    }
  }
}

Linkovi

Ukoliko postoji više stranica, postojat će također linkovi next i/ili prev koji će se pojaviti na svakoj osim zadnjoj odnosno prvoj stranici respektivno.

...

self

...

Link na ovaj resurs.

...

profile

...

Link na dokumentaciju.

Znanstvenik

Link za podatke o specifičnom znanstveniku

Pristup znanstvenici resursu

Http metoda GET se koristi za pristup ovom resursu.

Struktura odgovora

...

datumRodjenja

...

String

...

Datum rođenja znanstvenika.

...

spol

...

String

...

Spol znanstvenika.

...

jmbg

...

String

...

JMBG znanstvenika.

...

oib

...

String

...

OIB znanstvenika.

...

maticniBroj

...

String

...

Matični broj znanstvenika.

...

email

...

String

...

Email znanstvenika.

...

ime

...

String

...

Ime znanstvenika.

...

prezime

...

String

...

Prezime znanstvenika.

...

datumRodjenja

...

String

...

Datum rođenja znanstvenika.

...

zvanje

...

Array

...

Zvanje znanstvenika.

...

akademskiStupanj

...

Array

...

Akademski stupanj znanstvenika.

...

_links

...

Object

...

Linkovi na ostale resurse.

Primjer odgovora

Code Block
{
  "spol" : "M",
  "jmbg" : "2339452353116",
  "oib" : "31027653304",
  "maticniBroj" : "255432",
  "email" : "doku@mentacija",
  "ime" : "Acija",
  "prezime" : "Dokument",
  "zvanje" : [ {
    "zvanjeId" : 2,
    "zvanjeNaziv" : "profesor emeritus",
    "kratica" : "prof.emer.",
    "ustanova" : {
      "id" : 3330,
      "naziv" : "Testna Ustanova 1"
    },
    "datumIzbora" : "20.07.2000"
  } ],
  "akademskiStupanj" : [ ],
  "datumRodjenja" : "08.03.1905",
  "_links" : {
    "self" : {
      "href" : "https://croris.srce.hr/znanstvenici-api/znanstvenik/oib/31027653304"
    },
    "profile" : {
      "href" : "http://croris.srce.hr:443/znanstvenici-api/dokumentacija#resursi-znanstvenik"
    }
  }
}

Linkovi

...

self

...

Link na ovaj resurs.

...

profile

...

Programski generirana dokumentacija dostupna je na: https://www.croris.hr/znanstvenici-api/api-docs.html