V aplikaciji AllHours obstaja možnost, da se vključi vnos, izvoz ali popravek določenih podatkov preko API klicev.
Prvi korak je, da pridobimo kjuč s katerim bomo dostopali do aplikacije.
1. Odpremo Nastavitve/Napredno
2. Kliknemo na Ustvari nov API ključ in določimo poljubno ime
3. Ko kreiramo ključ se nam avtomatsko generirata Client ID in Client secret, ki ju bomo potrebovali za dostop.
Postopek je zaključen, ko je ključ izpisan pod poglavjem API. Tega lahko tudi izbrišete in tako odvzamete dostop ali pa jih kreirati več za različne aplikacije.
💡Vsi klici, ki jih trenutno podpiramo so dostopni na spletni strani API4
API dostop in primer uporabe
Storitev All Hours uporablja REST API (JSON), ki je dostopen na naslovu:
Na tem naslovu je na voljo tudi dokumentacija (Swagger) ter opis struktur in poizvedb.
Za povezavo s računom je potrebna avtentikacija. Uporabljajo se OAuth2 protokoli.
Primer uporabe: pridobivanje informacij o letnem dopustu
Najprej pridobite ID odsotnosti.
Ta podatek je običajno na voljo znotraj aplikacije, lahko pa ga pridobite tudi z API poizvedbo.
Ko imate ID odsotnosti, lahko izvedete API klic, ki vam vrne:
celoten letni dopust,
letni dopust za določeno obdobje,
dopust za določenega uporabnika.
Status kode (Absence status codes)
Statusni koda 0 pomeni, da za odsotnost ni bilo potrebno potrjevanje in je bila samodejno odobrena.
0 = samodejno odobrena odsotnost (ne gre čez workflow odobravanja)
1 = v odobravanju (pending)
2 = odobrena odsotnost
3 = zavrnjena odsotnost
4 = samodejno odobrena s tem da se pošlje potrdilo o samodejni odobritvi ostalim potrjevalcem