Lestu Vaktos-gögn í eigin skýrslum og ferlum

Stutt svar

Eigandi eða stjórnandi stofnar API-lykil og sendir hann sem Bearer-auðkenni. Lykillinn veitir lesaðgang að gögnum þess fyrirtækis sem hann tilheyrir.

API-ið hentar fyrir skýrslur, gagnavinnslu og innlestur í önnur ferli. Það breytir ekki vaktaplani eða samþykktum.

Sömu tímagögn og vaktstjóri yfirfer

Tímayfirlit API-sins byggir á sömu útreikningum og CSV-útflutningur og prentanlegt yfirlit í Vaktos.

Með require_approved=1 má krefjast þess að tímabilið hafi verið samþykkt áður en tímayfirlit er sótt.

Hvernig API-lyklarnir virka

• Bundinn við fyrirtæki. Lykillinn auðkennir sjálfur fyrirtækið sem gögnin tilheyra.
• Breitt read-heimildarsvið. Lyklar fá eina lesheimild, ekki sérheimildir á hvern endapunkt; allir skráðir endapunktar eru aðgengilegir gildum lykli.
• Sýndur einu sinni. Fullur lykill birtist aðeins við stofnun; glataðan lykil þarf að endurnýja.
• Hægt að afvirkja strax. Stjórnandi getur lokað lyklinum og aðgangur fellur niður samstundis.
• Beiðnatakmörk. Hver lykill má senda 600 beiðnir á mínútu; umfram það svarar þjónustan með 429.
• Bearer og JSON. Auðkenning fer fram með Authorization: Bearer <API_KEY> og svör eru á JSON-sniði.
• Lesaðgangur. Enginn endapunktur breytir gögnum í Vaktos.

Hvaða gögn eru í boði

• Tímayfirlit: unnir, greiddir og áætlaðir tímar, yfirvinna, álagsflokkar, samningstímar og staða tímabils.
• Stimplanir: hráar færslur með since-merki fyrir stigvaxandi samstillingu, þar á meðal ógildar færslur.
• Tímabil: staða viku eða mánaðar og upplýsingar um samþykkt.
• Vaktir: síun eftir vinnustað, deild, starfsmanni og stöðu, þar á meðal drög og ferill einstakrar vaktar.
• Frí: samþykkt frí sjálfgefið og aðrar stöður ef óskað er.
• Grunnskrár: starfsfólk, hlutverk, deildir og vinnustaðir.

Dæmi: samþykktir tímar sóttir fyrir launavinnslu

1. Athugaðu með timesheet-periods hvort tímabilið sé samþykkt.
2. Sæktu timesheets?period=month&month=2026-09&require_approved=1.
3. Flyttu niðurstöðuna inn í ykkar eigið áframhaldandi ferli.

Ef tímabilið er enn opið svarar krafa um samþykkt tímabil með 409. Tímastimplar vakta og stimplana eru í UTC en dagsetningarmörk tímayfirlita fylgja tímabelti fyrirtækisins.

Gott að hafa í huga

• API-ið er almennur lesaðgangur, ekki tilbúin nafngreind tenging við launa- eða bókhaldskerfi.
• CSV, prentanlegt yfirlit og tímayfirlit API-sins byggja á sömu tímagögnum.
• Án require_approved getur API-ið skilað gögnum úr opnu tímabili.
• API-ið reiknar hvorki laun né skatt og býr ekki til launaseðla.

Notar fyrirtækið MarRest? Vinnu- og hvíldartímagögn tengdra skipa haldast í MarRest. API-ið hér lýsir gögnum úr sjálfstæðu Vaktos-ferli. Sjá verkaskiptingu kerfanna.

Algengar spurningar

Hver getur búið til API-lykil?

Eigandi eða stjórnandi stofnar lykil undir Stillingar → API-lyklar. Fullur lykill birtist aðeins við stofnun og Vaktos geymir síðan aðeins tætigildi hans.

Er hægt að breyta gögnum í gegnum API?

Nei. API Vaktos veitir eingöngu lesaðgang. Vaktir, samþykktir og aðrar rekstrarákvarðanir eru áfram unnar inni í Vaktos.

Hvaða gögn eru aðgengileg?

Tímayfirlit, hráar stimplanir, staða tímabila, vaktir, frí, starfsfólk, deildir og vinnustaðir. Tímayfirlit getur meðal annars innihaldið unna, greidda og áætlaða tíma, yfirvinnu og valda álagsflokka.

Getur lykill lesið gögn annars fyrirtækis?

Nei. Hver lykill er bundinn við eitt fyrirtæki og fyrirtækisauðkenni er ekki valið af þeim sem sendir beiðnina.

Hvaða tæknilegu takmörk gilda?

Hámarkið er 600 beiðnir á mínútu fyrir hvern lykil; umframbeiðnir fá 429. Lyklar hafa breitt lesheimildarsvið (read), ekki sérheimildir á hvern endapunkt. Afvirkjun tekur gildi strax. Tímastimplar vakta og stimplana eru í UTC en tímabil tímayfirlita fylgja staðbundnum dagsetningum og tímabelti fyrirtækisins.

Skoða einnig

• Samþykktir tímar
• Stimplun og mæting
• Vaktos og MarRest
• Vaktaleiðrétting