Ultimo aggiornamento il 6 novembre 2026
Come usare l'API aperta (OpenAPI)?
Il nostro componente aggiuntivo API aperta collega Vacation Tracker ai tuoi strumenti. Crea una chiave API, scegli cosa può fare e usala per leggere e modificare i tuoi dati o per ricevere una notifica quando qualcosa cambia.
Guarda il tutorial
Una breve presentazione del componente aggiuntivo API aperta:
Come creare una chiave API
- Accedi al tuo account Vacation Tracker su app.vacationtracker.io/signin.
- Apri Integrazioni dal menu a sinistra (in Impostazioni spazio di lavoro).
- Fai clic sulla scheda API. Si apre la pagina API aperta.
- Nella sezione Chiavi API, fai clic su Crea chiave API.
- Inserisci un Nome della chiave. Questo nome è visibile solo alle persone della tua azienda.
- Facoltativamente, inserisci un Nome dell'integrazione. Le persone lo vedono in Vacation Tracker accanto a ogni modifica effettuata dalla chiave, ad esempio “Approvato da Jane (tramite Payroll sync)”. Lascialo vuoto per mostrare solo il nome della persona.
- In Permessi, scegli un modello e modificalo se necessario (vedi sotto).
- In Scadenza, scegli quando scade la chiave: tra 30 giorni, tra 90 giorni, tra 1 anno (consigliato) o mai.
- Controlla il Riepilogo e fai clic su Crea chiave API.
- Copia la chiave e conservala in un luogo sicuro. La chiave completa viene mostrata una sola volta, al momento della creazione.
Scegliere i permessi
Parti da un modello, poi adattalo:
Ogni permesso può essere impostato su Nessun accesso, Lettura o Lettura e scrittura. Approvare e rifiutare richieste, vedere i nomi dei tipi di congedo nascosti e agire per conto di altri utenti sono caselle di controllo separate, quindi attivale solo se il tuo strumento ne ha bisogno. Una chiave può fare solo ciò che tu puoi fare in Vacation Tracker.
Gestire le chiavi
La tabella Chiavi API elenca tutte le chiavi del tuo spazio di lavoro con proprietario, permessi, ultimo utilizzo, data di scadenza e stato. Fai clic su una chiave per aprirne i dettagli, dove puoi:
Ti inviamo un'email 14 giorni prima della scadenza di una chiave.
Effettuare la prima richiesta
L'URL di base è https://api.vacationtracker.io/v2. Invia la tua chiave come bearer token nell'header Authorization:
Una chiamata riuscita restituisce i dati in data. Gli elenchi con più pagine includono anche un nextToken, da ripassare per ottenere la pagina successiva.
Se qualcosa va storto, la risposta include un error con un codice, una descrizione e una soluzione. Una chiave mancante o sconosciuta restituisce 401. Una chiave senza il permesso richiesto da una richiesta restituisce 403 con INSUFFICIENT_SCOPE.
Guide all'integrazione
Le nostre guide all'integrazione illustrano passo per passo le attività più comuni, con esempi, e spiegano quando usare l'API, il server MCP, Vee o Zapier:
Come aggiungere un webhook
- Nella pagina del componente aggiuntivo API aperta, vai a Webhook e fai clic su Gestisci webhook.
- Fai clic su Aggiungi webhook.
- Inserisci l'URL dell'endpoint che deve ricevere gli eventi. Deve usare HTTPS.
- In Eventi, scegli Decisioni sui congedi, Tutte le attività sulle assenze, Mantieni una copia completa sincronizzata oppure Personalizzato per scegliere tu gli eventi.
- Fai clic su Aggiungi webhook.
Ricevi eventi solo per i dati che hai il permesso di vedere.
Quote e limiti di frequenza
I limiti si applicano per singola chiave API:
Se la tua integrazione ha bisogno di più richieste, scrivi a developers@vacationtracker.io indicando il nome della tua azienda, l'integrazione e il traffico previsto.
Domande frequenti
Dipende dall'attività. Usa l'API quando qualcuno nel tuo team può scrivere ed eseguire codice per collegare Vacation Tracker agli altri tuoi sistemi, con i webhook per reagire alle modifiche. Zapier offre lo stesso tipo di automazione senza codice, ma ha meno funzioni dell'API. Il server MCP permette al tuo assistente di IA, come Claude o ChatGPT, di rispondere alle domande e di eseguire azioni, una richiesta alla volta. Vee è integrato e non richiede alcuna configurazione: i dipendenti fanno domande sui propri congedi e li richiedono in linguaggio naturale. Tutti e quattro sono inclusi in ogni piano a pagamento e molti team ne usano più di uno. Le nostre guide all'integrazione mostrano quale è adatto a ogni attività.
No. Il componente aggiuntivo API aperta è incluso nei piani Core e Complete senza costi aggiuntivi.
La chiave completa viene mostrata una sola volta e non può essere recuperata. Apri la chiave e fai clic su Ruota chiave per ottenerne una nuova, poi aggiorna lo strumento che la usa. Se la vecchia chiave potrebbe essere stata divulgata, scegli di disattivarla subito.
Usa l'API con i webhook. Carica una volta i congedi approvati che hai già, poi lascia che i webhook ti avvisino quando un congedo viene approvato, modificato, annullato o eliminato, e rileggi ogni volta il congedo così la tua copia resta corretta. Zapier funziona per i flussi semplici, ma non carica i congedi passati e non ritenta gli eventi persi. Consulta Come inviare i congedi approvati a un HRIS o a un sistema di gestione delle buste paga.
Prossimi passi
Come collegare Vacation Tracker a Zapier? Come collegare Vacation Tracker ai miei strumenti di IA con il server MCP? Come esportare un rapporto delle richieste di congedo (cronologia dei congedi)?Amministratori e approvatori: puoi contattarci tramite chat dal vivo dal lunedì al venerdì, dalle 9:00 alle 17:00 (EST), oppure scriverci in qualsiasi momento a hello@vacationtracker.io.