Integrace se Zapierem

Propojte Working Timer s tisíci aplikací v Zapieru. Pracovní záznam lze například vytvořit z události kalendáře, formuláře, řádku tabulky nebo dokončeného úkolu.

Integrace používá veřejné API Working Timeru. Heslo k Working Timeru nemusíte se Zapierem sdílet.

Co potřebujete

• Účet Working Timer s aktivním tarifem nebo zkušební verzí Public API
• Placený tarif Zapier s API by Zapier nebo Webhooks by Zapier
• ID profilu Working Timer, do kterého se mají záznamy ukládat

Důležité: S API klíčem zacházejte jako s heslem. Nevkládejte jej do názvu, poznámky, URL ani jiného pole Zapu, které se může zobrazit v historii úloh.

1. Vytvoření API klíče

1. Otevřete portál Working Timer API, zvolte Sign In a přihlaste se.
2. V API Dashboard najděte API Keys a zvolte New Key.
3. Zadejte název, například Zapier, a zvolte Create.
4. Klíč začínající wt_ak_ ihned zkopírujte. Zobrazí se pouze jednou.

Pokud klíč ztratíte, zrušte jej a vytvořte nový.

2. Zjištění ID profilu

1. Otevřete referenci API.
2. Zvolte Authorize a vložte klíč do pole ApiKey.
3. Otevřete GET /api/v1/Profile, zvolte Try it out a Execute.
4. V odpovědi najděte profil a zkopírujte jeho id.

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

3. Připojení přes API by Zapier

1. V Zapieru otevřete Apps, zvolte Add connection a vyberte API by Zapier.
2. Jako Authentication type vyberte Static Headers (API key).
3. Do Headers vložte jeden řádek:

X-Api-Key: wt_ak_vas_api_klic

4. Nastavte Connection name na Working Timer.
5. Nastavte Domain filter na api.workingtimer.com.
6. Do Test URL vložte https://api.workingtimer.com/api/v1/Profile?pageSize=1.
7. Zvolte Yes, Continue to API by Zapier.

API by Zapier je funkce beta. Pokud ji nemáte k dispozici, použijte níže uvedenou metodu Webhooks.

4. Vytvoření prvního Zapu

1. Vytvořte Zap a vyberte spouštěč, například novou událost, úkol, formulář nebo řádek tabulky.
2. Přidejte akci API by Zapier, událost API Request, a vyberte připojení 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": "Vytvořeno pomocí Zapieru"
}

5. Nahraďte ID_PROFILU, namapujte hodnoty ze spouštěče a podle potřeby je nejprve upravte pomocí Formatter by Zapier.
6. Zvolte Test step. Úspěšný požadavek vrátí stav 201. Záznam ověřte ve Working Timeru a Zap publikujte.

clockIn a clockOut jsou minuty od půlnoci: 08:00 = 480, 09:00 = 540, 17:00 = 1020. U noční směny může být clockOut vyšší než 1440.

Alternativa: Webhooks by Zapier

Přidejte akci Webhooks by Zapier s událostí POST. Nastavte URL na https://api.workingtimer.com/api/v1/WorkRecord, Payload Type na JSON, vložte výše uvedená data a přidejte hlavičky X-Api-Key s vaším klíčem a Content-Type s hodnotou application/json. Úspěšný test vrátí 201.

Další užitečné požadavky

• Profily: GET https://api.workingtimer.com/api/v1/Profile
• Záznamy: GET https://api.workingtimer.com/api/v1/WorkRecord
• Aktualizace: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
• Odstranění: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Další endpointy najdete v referenci API.

Řešení problémů

• 401 Unauthorized — klíč chybí, je neúplný nebo zrušený. Název hlavičky musí být přesně X-Api-Key.
• 403 Forbidden — aktivujte nebo obnovte tarif či zkušební verzi Public API.
• 400 Bad Request — zkontrolujte JSON, datum a číselné hodnoty minut.
• Profile was not found — ověřte, že profileId patří ke stejnému účtu.
• 429 Too Many Requests — byl dosažen limit API; zkuste to později a zkontrolujte využití.
• Duplicitní záznamy — zkontrolujte historii Zapieru a před akcí použijte filtr nebo jedinečné ID.

Přístup zrušíte v API Dashboard volbou Revoke u klíče Zapier.