ISSP REST API tehnička dokumentacija

Općenito

Dokument opisuje ISSP REST API i izložene resurse. ISSP REST API je namijenjen programskoj interakciji sa sustavima ISSP i ISAK. ISSP REST API bazira se na Hypertext Transfer Protocol-u (HTTP) opisanom na adresi http://www.w3.org/Protocols/. Za korištenje ISSP REST API-ja potrebno je obaviti HTTP zahtjev i obraditi odgovor. Kod poziva se koriste standardne HTTP metode: GET, POST, PUT i DELETE.

---

Napomena: u trenutnoj verziji API podržava isključivo GET metodu nad izloženim resursima.
Jedini mogući pristup ISSP REST API-ju je kroz kriptirani kanal (HTTP Secure - SSL/TLS).

Autentikacija i autorizacija

Svaki zahtjev mora koristit Basic Authentication.
Zahtjev će biti autoriziran prema ovlastima definiranim za pojedinog korisnika, kategoriju podataka te metodu (pregled ili rad s resursima).

Primjer upotrebe - klijentska aplikacija

C# (System.Net.Http.HttpClient)

using (var client = new System.Net.Http.HttpClient())
{
  client.BaseAddress = new Uri("https://issp.srce.hr/api/");
  client.DefaultRequestHeaders.Accept.Clear();
  client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
  client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic",
  Convert.ToBase64String(Encoding.GetEncoding("iso-8859-1").GetBytes("userName" + ":" + "password")));
  // HTTP GET - Studenti/{oib}
  HttpResponseMessage response = client.GetAsync("Studenti/12345678901").Result;
  if (response.IsSuccessStatusCode)
  {
    Student stud = response.Content.ReadAsAsync<Student>().Result;
  }
}