+382 67 668 229Podrška na teritoriji Crne Gore
API dokumentacija

Podaci iz kadrovi.me u vašem sistemu

Knjigovodstveni program, ERP ili vaša aplikacija mogu čitati zaposlene, obračune, odsustva i ostale podatke preko API-ja – bez ručnog izvoza. API je samo za čitanje: ništa se ne mijenja u kadrovi.me.

1. Napravite token

U aplikaciji: Firma → Korisnici i pristup → API pristup (vlasnik ili administrator radnog prostora). Izaberite podatke (resurse), firme – pojedinačne ili „sve firme agencije“, i rok važenja (najviše godinu dana). Token se prikazuje samo jednom – sačuvajte ga na sigurnom mjestu. Može se opozvati ili regenerisati u svakom trenutku.

Token nikad ne vidi više od svog vlasnika: ako vlasniku promijenite ulogu, token odmah gubi ono što vlasnik više ne smije da vidi. Osjetljivi podaci (JMBG, računi, adresa, kontakti) dolaze samo ako je pri izradi tokena uključeno „Osjetljivi podaci“.

2. Pošaljite zahtjev

Adresa je https://api.kadrovi.me/api/v1. Token ide u zaglavlje Authorization:

curl -H "Authorization: Bearer kdr_…" https://api.kadrovi.me/api/v1
curl -H "Authorization: Bearer kdr_…" "https://api.kadrovi.me/api/v1/zaposleni?zaposlen=true&po_stranici=200"

GET /api/v1 vraća sam token: naziv, rok, resurse i firme na koje ima pristup – dobro za prvu provjeru.

Tokeni počinju sa kdr_. API pristup je iz bezbjednosnih razloga isključen dok ga ne odobri tim podrške kadrovi.me – zatražite ga na stranici API pristup u aplikaciji (za cijeli radni prostor ili za izabrane firme).

3. Resursi

GET /api/v1/<resurs> – red po zapisu. Token čita samo resurse koje ste mu dali.

ResursPodaciDodatni filteri
firmeFirme – naziv, PIB, adresa, djelatnost
zaposleniZaposleni – radni odnos, radno mjesto, zarada iz karticezaposlen=true|false
ugovoriUgovori o radu, rješenja i aneksizaposleni=<id>
radna-mjestaRadna mjesta (sistematizacija)
obracuniObračuni zarada – mjesec, datum isplate, stanjegodina, mjesec
obracun-stavkeStavke obračuna – bruto, neto, porez, prirez, doprinosi, satiobracun, zaposleni, godina, mjesec
odsustvaOdsustva – godišnji odmor, bolovanje i ostalozaposleni, od=YYYY-MM-DD
godisnji-odmoriGodišnji odmori – pravo, preneseno, iskorišćeno, preostalofirma i godina (obavezno / required)
obustaveObustave – krediti i zabrane: iznos, rate, dugzaposleni
ioppdIOPPD predaje – predato, kada, broj potvrdegodina

4. Parametri za sve resurse

  • firma=<id> – samo jedna firma (od onih na koje token ima pristup)
  • izmijenjeno_od=2026-10-01T00:00:00Z – samo zapisi izmijenjeni od tog trenutka (za redovnu sinhronizaciju)
  • po_stranici= – 100 redova podrazumijevano, najviše 500
  • posle=<vrijednost polja sljedeca> – sljedeća stranica
  • ukljuci_obrisane=1 – i obrisani (neaktivni) zapisi

5. Odgovor i stranice

{
  "resurs": "zaposleni",
  "broj": 100,
  "sljedeca": "8f1c…",
  "podaci": [ { "id": "…", "firmaId": "…", "prezime": "…", "ime": "…", "zaposlen": true, … } ]
}

Dok je sljedeca popunjeno, tražite sljedeću stranicu sa posle=<sljedeca>; kad je null, to su svi podaci. Iznosi su brojevi u eurima, datumi YYYY-MM-DD, vremena ISO u UTC-u.

6. Ograničenja i greške

Najviše 120 zahtjeva u minuti po tokenu. Svaki odgovor ima zaglavlja X-RateLimit-Limit, X-RateLimit-Remaining i X-Token-Istice (kad token ističe – podsjetnik stiže 7 i 1 dan ranije). Greška je JSON sa poljima kod i greska:

  • 401 – token nedostaje, nije ispravan, opozvan je ili mu je istekao rok
  • 403 – resurs ili firma nijesu dati tokenu, ili vlasnik tokena više nema to pravo
  • 400 – pogrešan parametar (npr. datum)
  • 429 – previše zahtjeva; pokušajte poslije vremena iz Retry-After (60 s)
  • 503 – API je privremeno zaustavljen (održavanje); pokušajte poslije Retry-After

Bezbjednost

Čuvamo samo otisak tokena (SHA-256), ne sam token. Svaki zahtjev se bilježi (vrijeme, putanja, IP adresa) i vidi se na stranici API pristup. Token držite na serveru – nikad u kodu web stranice ili mobilne aplikacije. Pisanje i webhook-ovi dolaze kasnije, na zahtjev – javite nam šta vam treba na podrska@kadrovi.me.