All Hours omogoča vnos, izvoz in popravke podatkov prek API klicev. Za dostop najprej ustvarite API ključ.
1. Odprite Nastavitve > Napredno in razširite razdelek API.
2. Kliknite Ustvari nov API ključ, vnesite ime, izberite avtorizacijsko shemo in kliknite Ustvari.
3. Sistem ustvari Client ID in Client Secret. Shranite ju na varno mesto, saj do njiju kasneje ne boste mogli več dostopati.
Ustvarjeni ključ je prikazan v razdelku API. Z izbrisom ključa odvzamete dostop; za različne aplikacije lahko ustvarite več ključev.
Opomba: Vsi podprti klici so opisani na strani API4.
API dostop in primer uporabe
All Hours uporablja REST API (JSON) na naslovu https://api4.allhours.com, kjer je na voljo tudi dokumentacija (Swagger) z opisom struktur in poizvedb.
Za povezavo je potrebna avtentikacija po protokolu OAuth2. Žeton pridobite na naslovu https://login.spica.com/connect/token (grant type client_credentials, scope api) z vašima Client ID in Client Secret.
Primer uporabe: pridobivanje informacij o letnem dopustu
Pridobite ID odsotnosti.
ID je viden v naslovu (URL) strani odsotnosti v Nastavitve > Dogodki, lahko pa ga pridobite tudi z API poizvedbo.
Izvedite API klic, ki vrne:
celoten letni dopust,
letni dopust za določeno obdobje,
dopust za določenega uporabnika.
Statusne kode odsotnosti
Polje s statusom odsotnosti ima naslednje vrednosti:
0 – samodejno odobrena (brez postopka odobravanja)
1 – v odobravanju
2 – odobrena
3 – zavrnjena
4 – samodejno odobrena, ostali potrjevalci prejmejo obvestilo o samodejni odobritvi