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
- Otwórz portal Working Timer API, wybierz Sign In i zaloguj się.
- W API Dashboard, w sekcji API Keys, wybierz New Key.
- Podaj nazwę, np.
Zapier, i wybierz Create. - 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
- Otwórz dokumentację API.
- Wybierz Authorize i wprowadź klucz w polu ApiKey.
- Otwórz
GET /api/v1/Profile, wybierz Try it out, a następnie Execute. - 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
- W Zapier otwórz Apps, wybierz Add connection, a potem API by Zapier.
- Jako Authentication type wybierz Static Headers (API key).
- W Headers dodaj jeden wiersz:
X-Api-Key: wt_ak_twoj_klucz_api
- Ustaw Connection name na
Working Timer. - Ustaw Domain filter na
api.workingtimer.com. - Jako Test URL podaj
https://api.workingtimer.com/api/v1/Profile?pageSize=1. - 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
- Utwórz Zap i wybierz wyzwalacz, np. nowe zdarzenie, zadanie, formularz lub wiersz.
- Dodaj API by Zapier, wybierz API Request i połączenie Working Timer.
- Ustaw Method na
POST, a URL nahttps://api.workingtimer.com/api/v1/WorkRecord. - 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"
}
- Zastąp
ID_PROFILU, przypisz wartości z wyzwalacza i w razie potrzeby najpierw przekształć je przez Formatter by Zapier. - 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
profileIdnależ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.