Integrácia so Zapierom

Úvod Prvé kroky Časovač — Sledovanie pracovného času Dashboard Mesačná tabuľka Ročné štatistiky Pridávanie a úprava záznamov Projekty Aktivity Šablóny Profil a nastavenia miezd Export a pracovné výkazy Geofencing Nastavenia aplikácie Synchronizácia a zálohy Kioskový režim (Terminál) Oznámenia a pripomienky Pracovné žiadosti Súbory a úložisko Premium a predplatné Integrácia so Zapierom

Integrácia so Zapierom

Prepojte Working Timer s tisíckami aplikácií cez Zapier. Pracovný záznam môžete napríklad vytvoriť z udalosti kalendára, formulára, riadka tabuľky alebo dokončenej úlohy.

Integrácia používa verejné API Working Timer. Heslo k Working Timeru nemusíte zdieľať so Zapierom.

Čo potrebujete

  • Účet Working Timer s aktívnym programom alebo skúšobnou verziou Public API
  • Platený program Zapier s API by Zapier alebo Webhooks by Zapier
  • ID profilu Working Timer, do ktorého sa budú ukladať záznamy

Dôležité: S API kľúčom zaobchádzajte ako s heslom. Nevkladajte ho do názvu, poznámky, URL ani poľa Zapu, ktoré sa môže zobraziť v histórii.

1. Vytvorenie API kľúča

  1. Otvorte portál Working Timer API, zvoľte Sign In a prihláste sa.
  2. V API Dashboard, v časti API Keys, zvoľte New Key.
  3. Zadajte názov, napríklad Zapier, a zvoľte Create.
  4. Kľúč začínajúci wt_ak_ ihneď skopírujte. Zobrazí sa iba raz.

Ak ho stratíte, zrušte ho a vytvorte nový.

2. Zistenie ID profilu

  1. Otvorte referenciu API.
  2. Zvoľte Authorize a vložte kľúč do poľa ApiKey.
  3. Otvorte GET /api/v1/Profile, zvoľte Try it out a potom Execute.
  4. V odpovedi nájdite profil a skopírujte jeho id.

ID je GUID podobný a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Pripojenie cez API by Zapier

  1. V Zapieri otvorte Apps, zvoľte Add connection a API by Zapier.
  2. Ako Authentication type vyberte Static Headers (API key).
  3. Do Headers pridajte jeden riadok:
X-Api-Key: wt_ak_vas_api_kluc
  1. Nastavte Connection name na Working Timer.
  2. Nastavte Domain filter na api.workingtimer.com.
  3. Do Test URL vložte https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Zvoľte Yes, Continue to API by Zapier.

API by Zapier je funkcia beta. Ak nie je dostupná, použite nižšie uvedenú metódu Webhooks.

4. Vytvorenie prvého Zapu

  1. Vytvorte Zap a vyberte spúšťač, napríklad novú udalosť, úlohu, formulár alebo riadok tabuľky.
  2. Pridajte API by Zapier, zvoľte API Request a pripojenie Working Timer.
  3. Nastavte Method na POST a URL na https://api.workingtimer.com/api/v1/WorkRecord.
  4. Do Body vložte:
{
  "profileId": "ID_PROFILU",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Vytvorené pomocou Zapieru"
}
  1. Nahraďte ID_PROFILU, namapujte hodnoty zo spúšťača a podľa potreby ich najprv upravte pomocou Formatter by Zapier.
  2. Zvoľte Test step. Úspešná požiadavka vráti 201. Záznam skontrolujte vo Working Timeri a Zap publikujte.

clockIn a clockOut sú minúty od polnoci: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Pri nočnej zmene môže byť clockOut vyšší ako 1440.

Alternatíva: Webhooks by Zapier

Pridajte Webhooks by Zapier s udalosťou POST. Nastavte URL na https://api.workingtimer.com/api/v1/WorkRecord, Payload Type na JSON, pridajte údaje vyššie a hlavičky X-Api-Key s vaším kľúčom a Content-Type s hodnotou application/json. Úspešný test vráti 201.

Ďalšie užitočné požiadavky

  • Profily: GET https://api.workingtimer.com/api/v1/Profile
  • Záznamy: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Aktualizácia: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Odstránenie: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Ďalšie endpointy nájdete v referencii API.

Riešenie problémov

  • 401 Unauthorized — kľúč chýba, je neúplný alebo zrušený. Hlavička sa musí volať presne X-Api-Key.
  • 403 Forbidden — aktivujte alebo obnovte program či skúšobnú verziu Public API.
  • 400 Bad Request — skontrolujte JSON, dátum a číselné hodnoty minút.
  • Profile was not found — overte, že profileId patrí k rovnakému účtu.
  • 429 Too Many Requests — dosiahli ste limit API; skúste to neskôr a skontrolujte využitie.
  • Duplicitné záznamy — skontrolujte históriu Zapieru a pred akciou použite filter alebo jedinečné ID zdroja.

Prístup odoberiete voľbou Revoke pri kľúči Zapier v API Dashboard.

Predchádzajúce Premium a predplatné