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.
| Resurs | Podaci | Dodatni filteri |
|---|---|---|
firme | Firme – naziv, PIB, adresa, djelatnost | |
zaposleni | Zaposleni – radni odnos, radno mjesto, zarada iz kartice | zaposlen=true|false |
ugovori | Ugovori o radu, rješenja i aneksi | zaposleni=<id> |
radna-mjesta | Radna mjesta (sistematizacija) | |
obracuni | Obračuni zarada – mjesec, datum isplate, stanje | godina, mjesec |
obracun-stavke | Stavke obračuna – bruto, neto, porez, prirez, doprinosi, sati | obracun, zaposleni, godina, mjesec |
odsustva | Odsustva – godišnji odmor, bolovanje i ostalo | zaposleni, od=YYYY-MM-DD |
godisnji-odmori | Godišnji odmori – pravo, preneseno, iskorišćeno, preostalo | firma i godina (obavezno / required) |
obustave | Obustave – krediti i zabrane: iznos, rate, dug | zaposleni |
ioppd | IOPPD predaje – predato, kada, broj potvrde | godina |
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 500posle=<vrijednost polja sljedeca>– sljedeća stranicaukljuci_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 rok403– resurs ili firma nijesu dati tokenu, ili vlasnik tokena više nema to pravo400– pogrešan parametar (npr. datum)429– previše zahtjeva; pokušajte poslije vremena izRetry-After(60 s)503– API je privremeno zaustavljen (održavanje); pokušajte poslijeRetry-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.