Ενσωμάτωση Zapier

Ενσωμάτωση Zapier

Συνδέστε το Working Timer με χιλιάδες εφαρμογές μέσω του Zapier. Για παράδειγμα, μπορείτε να δημιουργείτε εγγραφές εργασίας από συμβάντα ημερολογίου, φόρμες, γραμμές υπολογιστικών φύλλων ή ολοκληρωμένες εργασίες.

Η ενσωμάτωση χρησιμοποιεί το δημόσιο API του Working Timer. Δεν χρειάζεται να κοινοποιήσετε τον κωδικό πρόσβασής σας στο Zapier.

Τι χρειάζεστε

  • Λογαριασμό Working Timer με ενεργό πρόγραμμα ή δοκιμή Public API
  • Πληρωμένο πρόγραμμα Zapier με API by Zapier ή Webhooks by Zapier
  • Το ID του προφίλ Working Timer στο οποίο θα αποθηκεύονται οι εγγραφές

Σημαντικό: Αντιμετωπίστε το κλειδί API σαν κωδικό πρόσβασης. Μην το βάζετε σε όνομα Zap, σημείωση, URL ή πεδίο που μπορεί να εμφανιστεί στο ιστορικό.

1. Δημιουργία κλειδιού API

  1. Ανοίξτε την πύλη Working Timer API, επιλέξτε Sign In και συνδεθείτε.
  2. Στο API Dashboard, στην ενότητα API Keys, επιλέξτε New Key.
  3. Δώστε ένα όνομα όπως Zapier και επιλέξτε Create.
  4. Αντιγράψτε αμέσως το κλειδί που αρχίζει με wt_ak_. Εμφανίζεται μόνο μία φορά.

2. Εύρεση του ID προφίλ

  1. Ανοίξτε την αναφορά API.
  2. Επιλέξτε Authorize και εισαγάγετε το κλειδί στο πεδίο ApiKey.
  3. Ανοίξτε GET /api/v1/Profile, επιλέξτε Try it out και Execute.
  4. Βρείτε το προφίλ στην απόκριση και αντιγράψτε το id.

Το ID είναι GUID όπως a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Σύνδεση με API by Zapier

  1. Στο Zapier ανοίξτε Apps, επιλέξτε Add connection και API by Zapier.
  2. Στο Authentication type επιλέξτε Static Headers (API key).
  3. Στο Headers προσθέστε μία γραμμή:
X-Api-Key: wt_ak_to_kleidi_sas
  1. Ορίστε Connection name σε Working Timer.
  2. Ορίστε Domain filter σε api.workingtimer.com.
  3. Ορίστε Test URL σε https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Επιλέξτε Yes, Continue to API by Zapier.

Το API by Zapier είναι λειτουργία beta. Αν δεν είναι διαθέσιμο, χρησιμοποιήστε τη μέθοδο Webhooks παρακάτω.

4. Δημιουργία του πρώτου Zap

  1. Δημιουργήστε Zap και επιλέξτε ένα trigger, όπως νέο συμβάν, εργασία, φόρμα ή γραμμή φύλλου.
  2. Προσθέστε API by Zapier, ενέργεια API Request, και επιλέξτε τη σύνδεση Working Timer.
  3. Ορίστε Method σε POST και URL σε https://api.workingtimer.com/api/v1/WorkRecord.
  4. Στο Body εισαγάγετε:
{
  "profileId": "ID_PROFIL",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Δημιουργήθηκε από το Zapier"
}
  1. Αντικαταστήστε το ID_PROFIL, αντιστοιχίστε τιμές από το trigger και χρησιμοποιήστε πρώτα Formatter by Zapier όπου χρειάζεται.
  2. Επιλέξτε Test step. Η επιτυχία επιστρέφει κατάσταση 201. Ελέγξτε την εγγραφή στο Working Timer και δημοσιεύστε το Zap.

Τα clockIn και clockOut είναι λεπτά από τα μεσάνυχτα: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Σε νυχτερινή βάρδια το clockOut μπορεί να ξεπερνά το 1440.

Εναλλακτικά: Webhooks by Zapier

Προσθέστε Webhooks by Zapier με συμβάν POST. Ορίστε URL https://api.workingtimer.com/api/v1/WorkRecord, Payload Type JSON, τα παραπάνω δεδομένα και headers X-Api-Key με το κλειδί σας και Content-Type με application/json. Η επιτυχής δοκιμή επιστρέφει 201.

Χρήσιμα αιτήματα

  • Προφίλ: GET https://api.workingtimer.com/api/v1/Profile
  • Εγγραφές: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Ενημέρωση: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Διαγραφή: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Δείτε την αναφορά API για περισσότερα endpoints.

Αντιμετώπιση προβλημάτων

  • 401 Unauthorized — το κλειδί λείπει, είναι ελλιπές ή ανακλήθηκε. Το header πρέπει να είναι ακριβώς X-Api-Key.
  • 403 Forbidden — ενεργοποιήστε ή ανανεώστε το πρόγραμμα ή τη δοκιμή Public API.
  • 400 Bad Request — ελέγξτε το JSON, την ημερομηνία και τις αριθμητικές τιμές λεπτών.
  • Profile was not found — βεβαιωθείτε ότι το profileId ανήκει στον ίδιο λογαριασμό.
  • 429 Too Many Requests — συμπληρώθηκε όριο API· δοκιμάστε αργότερα και ελέγξτε τη χρήση.
  • Διπλές εγγραφές — ελέγξτε το ιστορικό του Zapier και χρησιμοποιήστε φίλτρο ή μοναδικό ID πριν από την ενέργεια.

Για ανάκληση πρόσβασης, επιλέξτε Revoke για το κλειδί Zapier στο API Dashboard.