Τεκμηρίωση API

Σύνδεση και εργασία με το Shifton API

Το Shifton API σας παρέχει πρόσβαση σε όλες τις βασικές λειτουργίες της πλατφόρμας — από τη διαχείριση προγραμμάτων έως τις ενσωματώσεις με εξωτερικά HR, μισθοδοσίας, και συστήματα αναλυτικής.
Χρησιμοποιώντας το API, μπορείτε να αυτοματοποιήσετε διαδικασίες και να συνδέσετε το Shifton με τις εσωτερικές υπηρεσίες της εταιρείας σας.

Τεκμηρίωση API

Υποστηρίζουμε δύο εκδόσεις της τεκμηρίωσής μας:

• 📄 Παλαιά Τεκμηρίωση — η προηγούμενη έκδοση της αναφοράς API (εξακολουθεί να υποστηρίζεται για υπάρχουσες ενσωματώσεις):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Νέα Τεκμηρίωση — η τρέχουσα έκδοση του API με ενημερωμένη δομή και τις πιο πρόσφατες μεθόδους:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Ξεκινώντας

Αποκτήστε ένα Κλειδί API

Στις ρυθμίσεις της εταιρείας σας στην πλατφόρμα Shifton, δημιουργήστε ένα κλειδί API.
Η εξουσιοδότηση γίνεται μέσω της κεφαλίδας:

Κάντε το πρώτο σας αίτημα

Για παράδειγμα, για να ανακτήσετε μια λίστα υπαλλήλων:

Παράδειγμα απάντησης:

Ενσωματώστε το API στις ροές εργασίας σας

• Δημιουργήστε και τροποποιήστε αυτόματα βάρδιες

• Διαχειριστείτε αιτήσεις αδειών και ασθενειών

• Εξαγάγετε δεδομένα σε συστήματα μισθοδοσίας

• Δημιουργήστε προσαρμοσμένα ταμπλό και αναφορές

Βασικές Δυνατότητες API

• Εργαζόμενοι – προσθέστε, επεξεργαστείτε και διαχειριστείτε ρόλους

• Προγράμματα – δημιουργήστε, προσαρμόστε τις βάρδιες, σχεδιάστε τη δουλειά

• Άδειες & Απουσίες – διαχείριση αιτημάτων για διακοπές και άδεια ασθενείας

• Αναφορές – εξαγωγή δεδομένων χρόνου, μισθοδοσίας και παρουσιών

Κωδικοί Σφαλμάτων

Το Shifton API χρησιμοποιεί τα πρότυπα HTTP κωδικών κατάστασης:

• 200 — Επιτυχής αίτηση

• 201 — Το αντικείμενο δημιουργήθηκε επιτυχώς

• 400 — Μη έγκυρες παράμετροι

• 401 — Σφάλμα εξουσιοδότησης (μη έγκυρο κλειδί API)

• 403 — Άρνηση πρόσβασης

• 404 — Πόρος δεν βρέθηκε

• 500 — Σφάλμα διακομιστή

Συμβουλές Χρήσης

• Πάντα να χρησιμοποιείτε την νέα έκδοση του API για νέες ενσωματώσεις

• Χρησιμοποιήστε Postman ή curl για δοκιμή

• Σέβεστε τα όρια ταχύτητας για να αποφύγετε να αποκλειστείτε

• Ενημερώστε τις ενσωματώσεις που εξακολουθούν να βασίζονται στην παλιά τεκμηρίωση