Otvoreni podaci

Gradska knjižnica Rijeka objavljuje nadolazeća javna događanja (radionice, predavanja, susrete, programe u ograncima) u strojno čitljivom obliku. Podaci su namijenjeni aplikacijama, portalima i kalendarima koji žele prenositi najave naših programa.

Adrese

Oba izvora sadrže iste podatke. Pristup je slobodan: bez prijave, bez ključa i bez parametara. iCalendar adresu možete dodati i izravno u vlastiti kalendar (Google Calendar, Outlook, Apple Calendar) kao pretplatu.

Što izvoz sadrži

• naslov događanja
• vrijeme početka i, ako je uneseno, završetka
• lokaciju: naziv ogranka ili vanjske lokacije, adresu i koordinate
• status (održava se / otkazano / odgođeno)
• poveznicu na službenu najavu na gkr.hr
• vrijeme zadnje izmjene

Izvoz ne sadrži fotografije ni cjelovite tekstove najava.

Koja su događanja uključena

Samo objavljena događanja koja tek predstoje. Događanje ostaje u izvozu još 24 sata nakon završetka (ili nakon početka, ako završetak nije unesen), a zatim se uklanja. Arhiva prošlih događanja nije dio izvoza.

Vrijeme

Sva su vremena u izvozu izražena u UTC-u (u iCalendaru sa sufiksom Z, u JSON-u kao ISO 8601). Za prikaz ih preračunajte u vremensku zonu Europe/Zagreb, uz ljetno računanje vremena.

Lokacije i ogranci

Jedno događanje može imati više termina na različitim lokacijama, uključujući ogranke izvan Rijeke. U iCalendaru je svaki takav termin zaseban zapis (VEVENT) s vlastitim vremenom i lokacijom. U JSON-u su termini navedeni u polju locations; isGkrBranch označava je li riječ o ogranku GKR-a ili o vanjskoj lokaciji.

Ako događanje ima više termina, vrijeme završetka nije navedeno ni za jedan.

Izmjene i otkazivanja

• Izmjena: mijenja se LAST-MODIFIED (iCalendar), odnosno updatedAt (JSON).
• Otkazivanje: STATUS:CANCELLED, a naslov dobiva prefiks „OTKAZANO:“. U JSON-u "status": "cancelled".
• Odgoda: STATUS:TENTATIVE, u JSON-u "status": "postponed". Novi termin objavljuje se izmjenom istog zapisa.
• Zapis nestane iz izvoza: događanje je završilo ili je najava povučena. To samo po sebi ne znači da je otkazano.

Identifikator zapisa (UID, odnosno id događanja i id lokacije) ne mijenja se pri izmjenama, pa ga možete koristiti za prepoznavanje istog događanja.

Osvježavanje

Preporučujemo osvježavanje jednom na sat. Odgovori imaju ETag; pošaljite ga u zaglavlju If-None-Match i, ako nema promjena, dobit ćete 304 Not Modified. Izmjena na našoj strani može biti vidljiva u izvozu sa zakašnjenjem do dvadesetak minuta, pa češće osvježavanje nema smisla.

Primjer (JSON)

{
  "timezone": "Europe/Zagreb",
  "data": [
    {
      "id": 7166,
      "title": "ČkkČ: \"Žene koje vrište u sebi\"",
      "start": "2026-10-26T16:00:00.000Z",
      "end": null,
      "status": "scheduled",
      "updatedAt": "2026-07-02T04:38:58.111Z",
      "url": "https://gkr.hr/magazin/susreti-citateljskih-klubova/ckkc-zene-koje-vriste-u-sebi--a-7166",
      "locations": [
        {
          "id": 2741,
          "date": "2026-10-26T16:00:00.000Z",
          "name": "Knjižnica Čavle",
          "address": "Čavja 31, 51219 Čavle",
          "geo": { "latitude": 45.3561, "longitude": 14.4858 },
          "isGkrBranch": true
        }
      ]
    }
  ]
}

Vrijednosti polja status: scheduled, cancelled, postponed.

Uvjeti korištenja

• Podatke smijete prikazivati i privremeno pohranjivati (predmemorirati) uz navođenje izvora „Gradska knjižnica Rijeka“ i poveznicu na službenu najavu.
• Prijave na programe obavljaju se isključivo na stranicama GKR-a.
• Otkazana događanja molimo jasno označiti ili ukloniti pri sljedećem osvježavanju.
• Automatizirano preuzimanje ostalih stranica gkr.hr nije potrebno i molimo da ga ne koristite; sve navedeno dostupno je u izvozu.
• Format se može mijenjati. O većim izmjenama obavijestit ćemo na ovoj stranici.

Kontakt

Pitanja i prijave pogrešaka: magazin@gkri.hr