Versions Compared

Key

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

ISRHKO REST API je programsko sučelje namijenjeno programskoj interakciji s Informacijskim sustavom Hrvatskoga kvalifikacijskog okvira (ISRHKO). Za pristup sučelju potrebno je obratiti se Ministarstvu znanosti, obrazovanja i sporta na email hko@mzos hko@mzo.hr za dobivanje dopuštenja i korisničkih podataka za spajanje. Detaljnije o tome možete pročitati u poglavlju Upute za korištenje API-ja. 


ISRHKO REST API implementira web servis temeljen na Hypermediji, konkretnije na HATEOAS ograničenju REST arhitekture gdje servis dinamički daje informacije klijentima o REST sučelju kroz hipermediju koristeći linkove koje dodaje u odgovore. Implementacija je u skladu s Richardsonovim Maturity Modelom:

...

Ovakav REST API u Richardsonovom Maturity Modelu naziva se Level 3 - Hypermedia Controls. 


Implementacija koristi Hypertext Application Language (HAL). HAL specifikacija na standardan i jednostavan način omogućava povezivanje između resursa. Koristeći HAL i standardne HTTP metode (GET, POST, PUT i DELETE) API je lakše čitljiv i programeru i aplikaciji koja ga koristi te time i lakši za korištenje, istraživanje API-ja te za razvoj klijentskih aplikacija.

URL s dokumentacijom je https://hko.srce.hr/api/dokumentacija/api.html, a početni URL za dohvat podataka je https://hko.srce.hr/api. Svi ostali URL-ovi se mogu mijenjati kroz vrijeme.