Documentazione API

Connessione e lavoro con l’API Shifton

L’API di Shifton ti dà accesso a tutte le funzionalità principali della piattaforma — dalla gestione degli orari alle integrazioni con i sistemi HR, paghe, e di analisi..
Utilizzando l’API, puoi automatizzare i processi e collegare Shifton con i servizi interni della tua azienda.

Documentazione API

Supportiamo due versioni della nostra documentazione:

• 📄 Vecchia Documentazione — la versione precedente della referenza API (ancora supportata per le integrazioni esistenti):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nuova Documentazione — la versione attuale dell’API con una struttura aggiornata e i metodi più recenti:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Guida rapida

Ottieni una Chiave API

Nelle impostazioni della tua azienda sulla piattaforma Shifton, genera una chiave API.
L’autorizzazione viene effettuata tramite l’intestazione:

Fai la tua prima richiesta

Ad esempio, per ottenere un elenco di dipendenti:

Risposta esempio:

Integra l’API nei tuoi flussi di lavoro

• Crea e modifica automaticamente i turni

• Gestisci le richieste di ferie e di malattia

• Esporta i dati nei sistemi di payroll

• Crea dashboard e report personalizzati

Capacità principali delle API

• Dipendenti – aggiungi, modifica e gestisci i ruoli

• Programmi – crea, regola turni, pianifica il lavoro

• Permessi & Assenze – gestisci richieste di ferie e malattia

• Rapporti – esporta dati di tempo, paghe e presenze

Codici di errore

L’API di Shifton utilizza standardcodici di stato HTTP:

• 200 — Richiesta riuscita

• 201 — Oggetto creato con successo

• 400 — Parametri non validi

• 401 — Errore di autorizzazione (API key non valida)

• 403 — Accesso negato

• 404 — Risorsa non trovata

• 500 — Errore del server

Consigli d’uso

• Usa sempre lanuova versione dell’API per nuove integrazioni

• Usare Postman o curl per il testing

• Rispettare i limiti di velocità per evitare il blocco

• Aggiornare le integrazioni che ancora si basano sulla vecchia documentazione