# kdo-vodi.si

> Register javnih funkcij v Sloveniji: kdo je opravljal katero funkcijo, v kateri organizaciji, od kdaj do kdaj in po katerem uradnem viru. Vsak podatek je vezan na vir, iz katerega je bil prebran. Trenutni obseg: 3.818 oseb in 431 organizacij, podatkovno pokritje od leta 2022 naprej (župani, poslanci in državni svetniki, vlada in državni organi, občinski svetniki).

Licenca podatkov: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — prosta uporaba z navedbo vira; podrobneje na [strani o licenci](https://kdo-vodi.si/licenca). Posamezni viri imajo lastne licence, navedene v [viri.csv](https://kdo-vodi.si/data/viri.csv); viri z omejitvijo nekomercialne uporabe niso vključeni v javne izvoze.

## Pregledni seznami

Celotni, sproti generirani seznami — vsaka vrstica je vezana na uradni vir.

- [Vsi župani](https://kdo-vodi.si/zupani): trenutni župani vseh slovenskih občin, z datumom nastopa mandata.
- [Poslanci Državnega zbora](https://kdo-vodi.si/poslanci): poslanci trenutnega sklica s poslansko skupino.
- [Ministri](https://kdo-vodi.si/ministri): trenutna sestava vlade, vključno z ministri brez resorja.
- [Občine](https://kdo-vodi.si/obcine): vse slovenske občine s trenutnim županom.

Posamezna oseba je na `/oseba/{slug}`, posamezna organizacija na `/organ/{slug}`.

## API

Javni, samo bralni API. Brez avtentikacije, omejen na 60 zahtevkov na minuto na IP.
Odgovarja z `Access-Control-Allow-Origin: *`, zato je uporaben tudi neposredno iz brskalnika.

- [OpenAPI specifikacija](https://kdo-vodi.si/api/v1/openapi.json): strojno berljiv opis vseh končnih točk.
- [/api/v1/office-holders](https://kdo-vodi.si/api/v1/office-holders): nosilci funkcij — oseba, funkcija, organizacija, mandatni datumi, vir.
- [/api/v1/people](https://kdo-vodi.si/api/v1/people): osebe v registru; posamezna oseba na `/api/v1/people/{slug}`.
- [/api/v1/organizations](https://kdo-vodi.si/api/v1/organizations): organizacije in organi; posamezna organizacija na `/api/v1/organizations/{slug}`.
- [/api/v1/sources](https://kdo-vodi.si/api/v1/sources): viri, na katere so vezani podatki.
- [Dokumentacija API](https://kdo-vodi.si/api/docs): Swagger UI nad specifikacijo.

## Bulk podatki

Celoten javno izvozljiv del registra v CSV.

- [nosilci.csv](https://kdo-vodi.si/data/nosilci.csv): vsi nosilci funkcij z mandatnimi datumi in viri.
- [organizacije.csv](https://kdo-vodi.si/data/organizacije.csv): vse organizacije in organi.
- [viri.csv](https://kdo-vodi.si/data/viri.csv): seznam virov s tipom in licenco.

## Metodologija

- [Viri](https://kdo-vodi.si/viri): iz katerih virov je register sestavljen; uradni (primarni) viri so podlaga objavljenih podatkov, neuradni jih le dopolnjujejo.
- [Podatkovne vrzeli](https://kdo-vodi.si/vrzeli): česa register nima in zakaj — kateri organi nimajo znanega vodstva in kateri viri niso strojno berljivi.