Zapier Entegrasyonu

Zapier Entegrasyonu

Working Timer'ı Zapier üzerinden binlerce uygulamaya bağlayın. Örneğin bir takvim etkinliği, form, tablo satırı veya tamamlanan görevden çalışma kaydı oluşturabilirsiniz.

Entegrasyon Working Timer Public API'sini kullanır. Working Timer parolanızı Zapier ile paylaşmanız gerekmez.

Gereksinimler

  • Etkin Public API planı veya denemesi olan Working Timer hesabı
  • API by Zapier veya Webhooks by Zapier içeren ücretli Zapier planı
  • Kayıtların ekleneceği Working Timer profilinin ID'si

Önemli: API anahtarına parola gibi davranın. Görev geçmişinde görünebilecek Zap adı, not, URL veya alanlara eklemeyin.

1. API anahtarı oluşturma

  1. Working Timer API portalını açın, Sign In seçeneğine basıp oturum açın.
  2. API Dashboard içindeki API Keys bölümünde New Key seçeneğini seçin.
  3. Zapier gibi bir ad girip Create seçeneğine basın.
  4. wt_ak_ ile başlayan anahtarı hemen kopyalayın. Yalnızca bir kez gösterilir.

Anahtarı kaybederseniz iptal edip yenisini oluşturun.

2. Profil ID'sini bulma

  1. API referansını açın.
  2. Authorize seçeneğine basıp anahtarı ApiKey alanına girin.
  3. GET /api/v1/Profile bölümünü açıp Try it out, ardından Execute seçeneğine basın.
  4. Yanıtta profili bulun ve id değerini kopyalayın.

ID, a1b2c3d4-1234-5678-9abc-1234567890ab benzeri bir GUID'dir.

3. API by Zapier ile bağlanma

  1. Zapier'da Apps bölümünü açın, Add connection ve API by Zapier seçeneğini seçin.
  2. Authentication type olarak Static Headers (API key) seçin.
  3. Headers alanına tek satır ekleyin:
X-Api-Key: wt_ak_api_anahtariniz
  1. Connection name değerini Working Timer yapın.
  2. Domain filter değerini api.workingtimer.com yapın.
  3. Test URL olarak https://api.workingtimer.com/api/v1/Profile?pageSize=1 girin.
  4. Yes, Continue to API by Zapier seçeneğine basın.

API by Zapier beta özelliğidir. Hesabınızda yoksa aşağıdaki Webhooks yöntemini kullanın.

4. İlk Zap'i oluşturma

  1. Bir Zap oluşturup yeni etkinlik, görev, form veya tablo satırı gibi bir tetikleyici seçin.
  2. API by Zapier ekleyin, API Request eylemini ve Working Timer bağlantısını seçin.
  3. Method değerini POST, URL değerini https://api.workingtimer.com/api/v1/WorkRecord yapın.
  4. Body alanına şunu girin:
{
  "profileId": "PROFIL_ID",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Zapier tarafından oluşturuldu"
}
  1. PROFIL_ID değerini değiştirin, tetikleyici değerlerini eşleyin ve gerekiyorsa önce Formatter by Zapier ile dönüştürün.
  2. Test step seçeneğine basın. Başarılı istek 201 döndürür. Kaydı Working Timer'da kontrol edip Zap'i yayımlayın.

clockIn ve clockOut gece yarısından sonraki dakikadır: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Gece vardiyasında clockOut, 1440 değerini aşabilir.

Alternatif: Webhooks by Zapier

POST etkinliğiyle Webhooks by Zapier ekleyin. URL'yi https://api.workingtimer.com/api/v1/WorkRecord, Payload Type değerini JSON yapın; yukarıdaki verileri, anahtarınızla X-Api-Key ve application/json değeriyle Content-Type header'larını ekleyin. Başarılı test 201 döndürür.

Diğer yararlı istekler

  • Profiller: GET https://api.workingtimer.com/api/v1/Profile
  • Kayıtlar: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Güncelleme: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Silme: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Diğer endpoint'ler için API referansına bakın.

Sorun giderme

  • 401 Unauthorized — anahtar eksik, tamamlanmamış veya iptal edilmiştir. Header adı tam olarak X-Api-Key olmalıdır.
  • 403 Forbidden — Public API planını veya denemesini etkinleştirin ya da yenileyin.
  • 400 Bad Request — JSON, tarih ve sayısal dakika değerlerini kontrol edin.
  • Profile was not foundprofileId değerinin aynı hesaba ait olduğunu doğrulayın.
  • 429 Too Many Requests — API sınırına ulaşıldı; daha sonra deneyip kullanımı kontrol edin.
  • Yinelenen kayıtlar — Zapier geçmişini kontrol edin ve eylemden önce filtre veya benzersiz kaynak ID'si kullanın.

Erişimi kaldırmak için API Dashboard içinde Zapier anahtarında Revoke seçeneğini seçin.