Ενσωμάτωση 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
- Ανοίξτε την πύλη Working Timer API, επιλέξτε Sign In και συνδεθείτε.
- Στο API Dashboard, στην ενότητα API Keys, επιλέξτε New Key.
- Δώστε ένα όνομα όπως
Zapierκαι επιλέξτε Create. - Αντιγράψτε αμέσως το κλειδί που αρχίζει με
wt_ak_. Εμφανίζεται μόνο μία φορά.
2. Εύρεση του ID προφίλ
- Ανοίξτε την αναφορά API.
- Επιλέξτε Authorize και εισαγάγετε το κλειδί στο πεδίο ApiKey.
- Ανοίξτε
GET /api/v1/Profile, επιλέξτε Try it out και Execute. - Βρείτε το προφίλ στην απόκριση και αντιγράψτε το
id.
Το ID είναι GUID όπως a1b2c3d4-1234-5678-9abc-1234567890ab.
3. Σύνδεση με API by Zapier
- Στο Zapier ανοίξτε Apps, επιλέξτε Add connection και API by Zapier.
- Στο Authentication type επιλέξτε Static Headers (API key).
- Στο Headers προσθέστε μία γραμμή:
X-Api-Key: wt_ak_to_kleidi_sas
- Ορίστε Connection name σε
Working Timer. - Ορίστε Domain filter σε
api.workingtimer.com. - Ορίστε Test URL σε
https://api.workingtimer.com/api/v1/Profile?pageSize=1. - Επιλέξτε Yes, Continue to API by Zapier.
Το API by Zapier είναι λειτουργία beta. Αν δεν είναι διαθέσιμο, χρησιμοποιήστε τη μέθοδο Webhooks παρακάτω.
4. Δημιουργία του πρώτου Zap
- Δημιουργήστε Zap και επιλέξτε ένα trigger, όπως νέο συμβάν, εργασία, φόρμα ή γραμμή φύλλου.
- Προσθέστε API by Zapier, ενέργεια API Request, και επιλέξτε τη σύνδεση Working Timer.
- Ορίστε Method σε
POSTκαι URL σεhttps://api.workingtimer.com/api/v1/WorkRecord. - Στο Body εισαγάγετε:
{
"profileId": "ID_PROFIL",
"year": 2026,
"month": 7,
"day": 31,
"clockIn": 540,
"clockOut": 1020,
"breakMinutes": 30,
"recordType": "common",
"isPaid": true,
"note": "Δημιουργήθηκε από το Zapier"
}
- Αντικαταστήστε το
ID_PROFIL, αντιστοιχίστε τιμές από το trigger και χρησιμοποιήστε πρώτα Formatter by Zapier όπου χρειάζεται. - Επιλέξτε 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.