Integracja z Zapier

Integracja z Zapier

Połącz Working Timer z tysiącami aplikacji przez Zapier. Możesz na przykład tworzyć wpis czasu pracy ze zdarzenia kalendarza, formularza, wiersza arkusza lub ukończonego zadania.

Integracja korzysta z publicznego API Working Timer. Nie musisz udostępniać Zapierowi swojego hasła.

Wymagania

  • Konto Working Timer z aktywnym planem lub okresem próbnym Public API
  • Płatny plan Zapier z API by Zapier lub Webhooks by Zapier
  • ID profilu Working Timer, do którego trafią wpisy

Ważne: Traktuj klucz API jak hasło. Nie umieszczaj go w nazwie, notatce, adresie URL ani polu Zapa widocznym w historii zadań.

1. Utwórz klucz API

  1. Otwórz portal Working Timer API, wybierz Sign In i zaloguj się.
  2. W API Dashboard, w sekcji API Keys, wybierz New Key.
  3. Podaj nazwę, np. Zapier, i wybierz Create.
  4. Natychmiast skopiuj klucz zaczynający się od wt_ak_. Jest wyświetlany tylko raz.

Jeśli go zgubisz, unieważnij go i utwórz nowy.

2. Znajdź ID profilu

  1. Otwórz dokumentację API.
  2. Wybierz Authorize i wprowadź klucz w polu ApiKey.
  3. Otwórz GET /api/v1/Profile, wybierz Try it out, a następnie Execute.
  4. Znajdź profil w odpowiedzi i skopiuj jego id.

ID ma postać GUID, np. a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Połącz przez API by Zapier

  1. W Zapier otwórz Apps, wybierz Add connection, a potem API by Zapier.
  2. Jako Authentication type wybierz Static Headers (API key).
  3. W Headers dodaj jeden wiersz:
X-Api-Key: wt_ak_twoj_klucz_api
  1. Ustaw Connection name na Working Timer.
  2. Ustaw Domain filter na api.workingtimer.com.
  3. Jako Test URL podaj https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Wybierz Yes, Continue to API by Zapier.

API by Zapier jest funkcją beta. Jeśli nie jest dostępna, użyj opisanej niżej metody Webhooks.

4. Utwórz pierwszy Zap

  1. Utwórz Zap i wybierz wyzwalacz, np. nowe zdarzenie, zadanie, formularz lub wiersz.
  2. Dodaj API by Zapier, wybierz API Request i połączenie Working Timer.
  3. Ustaw Method na POST, a URL na https://api.workingtimer.com/api/v1/WorkRecord.
  4. W polu Body wpisz:
{
  "profileId": "ID_PROFILU",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Utworzono przez Zapier"
}
  1. Zastąp ID_PROFILU, przypisz wartości z wyzwalacza i w razie potrzeby najpierw przekształć je przez Formatter by Zapier.
  2. Wybierz Test step. Poprawne żądanie zwraca 201. Sprawdź wpis w Working Timer i opublikuj Zap.

clockIn i clockOut to minuty od północy: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Przy nocnej zmianie clockOut może przekraczać 1440.

Alternatywa: Webhooks by Zapier

Dodaj Webhooks by Zapier ze zdarzeniem POST. Ustaw URL https://api.workingtimer.com/api/v1/WorkRecord, Payload Type JSON, dodaj powyższe dane oraz nagłówki X-Api-Key z kluczem i Content-Type z wartością application/json. Udany test zwraca 201.

Inne przydatne żądania

  • Profile: GET https://api.workingtimer.com/api/v1/Profile
  • Wpisy: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Aktualizacja: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Usuwanie: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Pozostałe endpointy opisuje dokumentacja API.

Rozwiązywanie problemów

  • 401 Unauthorized — klucza brakuje, jest niepełny lub unieważniony. Nagłówek musi nazywać się dokładnie X-Api-Key.
  • 403 Forbidden — aktywuj lub odnów plan albo okres próbny Public API.
  • 400 Bad Request — sprawdź JSON, datę i liczbowe wartości minut.
  • Profile was not found — upewnij się, że profileId należy do tego samego konta.
  • 429 Too Many Requests — osiągnięto limit API; spróbuj później i sprawdź wykorzystanie.
  • Duplikaty — sprawdź historię Zapier i przed akcją użyj filtra lub unikalnego ID źródła.

Aby odebrać dostęp, wybierz Revoke przy kluczu Zapier w API Dashboard.