Panoramica per sviluppatori

La pagina Developer apre l’accesso alla documentazione API di Shifton e agli strumenti per la creazione di integrazioni personalizzate.

Istruzioni passo passo

Accesso alla pagina Developer

Nel pannello laterale sinistro, fare clic su Integrazioni.

Passare alla pagina Sviluppatore.

Nella parte superiore — tre schede: Panoramica, Webhook e Candidature.

Utilizzo della scheda Overview

Link	Descrizione
Nuova Documentoazione	Documentazione API aggiornata
Vecchia Documentoazione	Documentazione obsoleta per integrazioni esistenti

Fare clic sul link desiderato — la documentazione si aprirà in una nuova scheda.

Altre schede Developer

Webhook

mdash; configurare gli endpoint per notifiche sugli eventi in tempo reale.

Candidature

mdash; creare e gestire applicazioni personalizzate.

Domande frequenti

D: Quale Documentooazione utilizzare — nuova o vecchia?
Utilizzare Nuova Documentoazione per tutte le nuove integrazioni. Quella vecchia — solo per la retrocompatibilità.

D: La pagina Sviluppatore non viene visualizzata — perché?
La pagina è accessibile solo al Proprietario e all’Amministratore.

D: Ci sono Limiteei al numero di richieste API?
Sì. I dettagli sono nella documentazione API.

D: Dove trovare la chiave API per lavorare con l’API di turnoon?
Integrations → Sviluppatore → Candidature → creare un’applicazione → nelle impostazioni ottenere le credenziali API.

D: turnoon supporta OAuth 2.0?
Sì. L’autorizzazione tramite OAuth viene utilizzata per collegare applicazioni di terze parti. I dettagli sono nella documentazione API.

D: È possibile testare l’API senza creare un’applicazione?
Sì — utilizzare strumenti come Postman con le proprie credenziali. Per la produzione si consiglia di registrare un’applicazione.

D: Qual è la differenza tra New e Vecchia Documentoazione?
Nuova documentazione — aggiornata (consigliata per tutte le nuove integrazioni). Vecchia documentazione — per la retrocompatibilità con le integrazioni esistenti.

D: È possibile ottenere i dati dei Report tramite API?
Sì. L’API di Shifton fornisce accesso ai dati di Pianificazioni, Dipendenti e altre risorse. I dettagli sono nella documentazione.

D: I Webhook supportano tutti i tipi di eventi di turnoon?
No, solo alcuni. L’elenco degli eventi supportati è nella sezione Developer → Webhooks della documentazione.

D: Sono necessarie competenze tecniche per lavorare con l’API?
Sì. Per lavorare con la REST API e creare integrazioni tramite Applications sono necessarie competenze di sviluppo di base.

D: L’API è a pagamento o è inclusa nell’abboNomento?
L’API è disponibile nell’ambito dell’abbonamento senza costi aggiuntivi. Le limitazioni dipendono dal piano tariffario.

D: Come ottenere supporto in caso di problemi con l’integrazione tramite API?
Contattare il supporto Shifton con la descrizione della richiesta, della risposta e del codice di errore. Consultare anche la documentazione nella pagina Developer.

D: Qual è l’URL base dell’API di turnoon?
L’URL base è api2.shifton.com. I dettagli e gli esempi di richieste sono disponibili nella Nuova documentazione.

D: L’API supporta la paginazione per richieste di elenchi di grandi dimensioni?
Sì. I dettagli sull’implementazione della paginazione sono descritti nella documentazione API.

D: È possibile creare ed eliminare Turni tramite API?
Sì. L’API fornisce accesso CRUD completo a Turni, Dipendenti, Pianificazioni e altre risorse.

D: Esiste un ambiente sandbox per testare l’API?
Non esiste un ambiente sandbox dedicato. Si consiglia di creare un’azienda di test in Shifton per testare in sicurezza.

D: Quali Formareareati di dati supporta l’API?
L’API utilizza il formato JSON per richieste e risposte.