Razvijalci

Dostop do API-jev in orodij za integracijo: podatke Geo kazala KAM lahko vgradite v svoje aplikacije, spletne strani in analitične sisteme.

REST API /api/v2

Tretjim osebam je na voljo REST vmesnik /api/v2. Avtentikacija poteka s ključem v glavi X-API-Key; vsak ključ je vezan na konkretno platformo in natančno določene obsege dostopa (na primer events:read za branje koledarja prireditev). Ključi obstajajo v produkcijski in testni različici, dostop je zabeležen in omejen s kvotami.

curl -H "X-API-Key: itk_test_..." https://racunalniske-resitve.si/api/v2/events

Odgovori so JSON z enotno ovojnico in jasnimi kodami napak. Nabor virov raste po modulih: dogodki, geo-točke, vsebine.

Brez avtentikacije sta na voljo iskanje po strani (GET /isci/results?q=..., predlogi na /isci/suggestions) in žive statistike (GET /api/site_stats).

Vgradnja zemljevida (iFrame)

Zemljevidni sloj se v obstoječo stran vgradi z enim elementom iFrame, brez posega v vašo tehnologijo. Enako vgradnjo uporabljamo tudi sami na strani Geo kazala KAM.

<iframe src="https://savinjska.kupujlokalno.si/geo-kazalo-kam?embed=minimal"
        title="Geo kazalo KAM" loading="lazy"></iframe>

Odprite cilj vgradnje v živo: isti naslov, kot ga bere iFrame.

Podatki in formati

Poti so na voljo kot GPX-sledi s pretvorbo v GeoJSON, geo-točke s koordinatami, kategorijami in skrbniki, dogodki pa s strukturiranimi termini in lokacijami. Standardizirani opisi točk so pripravljeni za rabo v AI-asistentih: vsebine imajo jasen vir, skrbnika in lokacijo.

Za AI agente

Če ste AI agent ali gradite zanje: strojno berljiv zemljevid vsebin je na /llms.txt, navodila za delo s stranjo (poizvedbe, povpraševanja, API) pa na /agents.md. Žive statistike so brez avtentikacije na /api/site_stats. Oboje je navedeno tudi v robots.txt.

Dostop

API-ključ izdamo po dogovoru: opišite svoj primer uporabe in katere podatke potrebujete. Testni ključ za razvoj je brezplačen.

Zaprosite za API-ključ Nazaj na Geo kazalo KAM

Viri, obsegi in omejitve

Omejitve na ključ: 60 zahtevkov/minuto in 10.000 zahtevkov/dan (ob prekoračitvi HTTP 429 z glavo Retry-After), stranska velikost do 50 zapisov. Verzioniranje je v poti (/api/v2); spremembe znotraj verzije so združljive za nazaj.

Primer odgovora

{
  "success": true,
  "page": 1,
  "limit": 20,
  "has_more": false,
  "items": [
    {
      "event_id": "123",
      "naziv": "Prireditev ob Savinji",
      "starts_at": "2026-08-01T18:00:00+02:00",
      "location": { "label": "Mozirje", "lat": 46.339, "lng": 14.963 }
    }
  ]
}