MASKDokumentacija
Englishmask.baKontakt

Integracije i API

MASK se povezuje s vašim softverom. Sistem za plate, kadrove, ERP ili kontrolu pristupa može sam preuzimati evidenciju radnog vremena iz MASK-a i slati podatke u MASK, bez ručnog izvoza i uvoza. Ovdje su odgovori na pitanja koja nam najčešće postavljate; tehnička dokumentacija za programere je u API dokumentaciji (na engleskom).

Postoji li API?#

Da. MASK ima integracijski REST API koji radi preko HTTPS-a i razmjenjuje podatke u JSON formatu. Pristup se odobrava API ključem: administrator vašeg MASK sistema kreira ključ na stranici API ključevi u web aplikaciji, odredi šta ključ smije čitati ili mijenjati i za koje lokacije, i preda ga vašem programeru.

Da li je API uključen u standardnu licencu?#

API je dio MASK sistema i dostupan je svim korisnicima. Da li je uključen u vaš paket ili se ugovara kao dodatak zavisi od obima integracije: koliko sistema povezujete i koje podatke razmjenjujete. To dogovaramo u ponudi, pa nam pišite i opišite šta želite povezati.

Koji podaci su dostupni?#

Vaš sistem kroz API može čitati:

  • Zaposlene i njihova zaposlenja po lokacijama: vrstu ugovora, satnicu, datum početka i kraja.
  • RFID kartice zaposlenih.
  • Događaje evidencije: svaki ulaz i izlaz, pauze, službene i privatne izlaske, s tačnim vremenom, izvorom (terminal, ručni unos, API) i ispravkama.
  • Smjene koje MASK izračuna iz događaja, s vremenom rada, pauza, privatnih i službenih izlazaka.
  • Izvještaje: radne dane, sate i odsustva po lokaciji za period, mjesečni obračun za plate i smjene pojedinog zaposlenog.
  • Osnovne podatke: lokacije (u sistemu: institucije) s vremenskom zonom, i vrste događaja.

I upisivati:

  • Zaposlene i zaposlenja: novog zaposlenog, izmjenu podataka, završetak i ponovno aktiviranje zaposlenja. Tako MASK ostaje usklađen s vašim kadrovskim sistemom.
  • Događaje evidencije iz vašeg sistema, na primjer s ulaza pod kontrolom pristupa, uz ispravke i poništavanja.

Svaki ključ vidi samo ono za šta je ovlašten: odabrane vrste podataka, samo za čitanje ili i za upis, i odabrane lokacije. Ključ može imati rok trajanja, listu dozvoljenih IP adresa i vlastito ograničenje broja zahtjeva, a administrator ga može izmijeniti, zamijeniti ili ugasiti u svakom trenutku.

Mogu li podaci s terminala automatski stizati u naš sistem?#

Da, na dva načina.

Preko MASK-a i API-ja. Svako prislanjanje kartice stiže u MASK čim je terminal na mreži; bez veze terminal čuva zapis i šalje ga kada se mreža vrati. Vaš sistem zatim preko API-ja preuzima nove događaje i smjene u ritmu koji vam odgovara, na primjer svakih nekoliko minuta ili jednom noću, potpuno automatski. Ovo je preporučeni način: osim prislanjanja dobijate i izračunate smjene, ispravke administratora i izvještaje.

Direktno s terminala. Terminal se može podesiti da zapise šalje direktno u vaš sistem, bez MASK softvera između. To je posebno rješenje koje prilagođavamo vašem sistemu; javite nam se za detalje.

Postoji li API dokumentacija i tehnička specifikacija?#

Da, javno je dostupna:

  • API dokumentacija: autentifikacija, ovlaštenja, greške, ograničenja, preporučeni tokovi sinhronizacije i primjer za svaki zahtjev (na engleskom).
  • OpenAPI 3 specifikacija: mašinski čitljiv opis cijelog API-ja, koji uvozite u Postman, Insomniju ili generator klijentskog koda.

API je verzionisan. Izmjene unutar verzije v1 ne kvare postojeće integracije, osim ispravki sigurnosnih propusta; promjena koja bi ih pokvarila dobija novu verziju, najavljenu unaprijed (pravila).

Kompletan sistem na vašoj infrastrukturi#

MASK ne mora raditi u našem cloudu. Možete ga dobiti i kao kompletan sistem na vlastitim serverima, pa i potpuno unutar interne mreže, bez ijedne javne adrese. Pogledajte načine isporuke.

Kontakt#

Ako već koristite MASK, ključ za vaš sistem kreira vaš administrator na stranici API ključevi.