SOURCE: Vacation Tracker TITLE: Come usare l'API aperta (OpenAPI)? URL: https://vacationtracker.io/it/base-di-conoscenza/come-usare-l-api-aperta-openapi/ LANG: it PUBLISHED: 2026-10-06 UPDATED: 2026-11-02 READING: 4 min SUMMARY: Scopri come creare una chiave API in Vacation Tracker, sceglierne i permessi e usare l'API aperta e i webhook per leggere e modificare i tuoi dati. # Come usare l'API aperta (OpenAPI)? # 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 (https://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: - Sola lettura: vede i dati, non modifica nulla. Adatto a rapporti e dashboard. - Gestione dei congedi: richiede, aggiunge e approva congedi. Legge utenti e tipi di congedo. - Configurazione dello spazio di lavoro: configura sedi, dipartimenti, tipi di congedo, politiche, festività e utenti. - Personalizzato: scegli tu ogni singolo permesso. 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: - Vedere l'utilizzo di questo mese e modificare il nome e i permessi della chiave. - Controllare l'Attività recente, che elenca ogni richiesta che ha modificato dati. - Fare clic su Ruota chiave per ottenere una nuova chiave con lo stesso nome e gli stessi permessi. Scegli se la vecchia chiave continua a funzionare per 24 ore (consigliato), per 7 giorni o smette subito di funzionare. - Fare clic su Revoca per disattivare la chiave definitivamente. 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: curl https://api.vacationtracker.io/v2/departments \ -H "Authorization: Bearer vt_live_..." Una chiamata riuscita restituisce i dati in data. Gli elenchi con più pagine includono anche un nextToken, da ripassare per ottenere la pagina successiva. { "data": [ ... ], "nextToken": "..." } 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. Documentazione tecnica completa Tutti gli endpoint, i parametri, i codici di errore e gli eventi webhook si trovano nella nostra documentazione per sviluppatori (https://vacationtracker.io/developers/api-v2). Puoi aprirla anche con il pulsante Apri documentazione nella pagina del componente aggiuntivo API aperta. ## 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: - Fino a 30.000 richieste al mese. - 10 richieste al secondo, con picchi fino a 50 richieste. Se la tua integrazione ha bisogno di più richieste, scrivi a developers@vacationtracker.io (mailto:developers@vacationtracker.io) indicando il nome della tua azienda, l'integrazione e il traffico previsto. Chiavi API meno recenti Le chiavi create prima dell'API v2 sono elencate in Chiavi legacy (API v1). Continuano a funzionare, ma possono solo leggere i dati e non funzionano con l'API v2. Per modificare i dati tramite l'API, crea una nuova chiave e segui la nostra guida alla migrazione (https://vacationtracker.io/developers/api-v2/migration). ## Domande frequenti Devo usare l'API, Zapier o il server MCP? Dipende da cosa devi fare. L'API è pensata per il tuo codice e i tuoi strumenti, con i webhook per reagire alle modifiche. Zapier è l'opzione senza codice. Il server MCP collega uno strumento di IA come Claude o ChatGPT, così puoi fare domande in linguaggio naturale. Molti team ne usano più di uno. L'API ha un costo aggiuntivo? No. Il componente aggiuntivo API aperta è incluso nei piani Core e Complete senza costi aggiuntivi. Cosa succede se perdo una chiave? 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. ### Prossimi passi Come collegare Vacation Tracker a Zapier? (https://vacationtracker.io/it/base-di-conoscenza/come-collegare-vacation-tracker-a-zapier/) Come collegare Vacation Tracker ai miei strumenti di IA con il server MCP? (https://vacationtracker.io/it/base-di-conoscenza/come-collegare-vacation-tracker-ai-miei-strumenti-di-ia-con-il-server-mcp/) Come esportare un rapporto delle richieste di congedo (cronologia dei congedi)? (https://vacationtracker.io/it/base-di-conoscenza/come-esportare-un-rapporto-delle-richieste-di-congedo-cronologia-dei-congedi/) Hai bisogno di aiuto? Contatta il nostro team di supporto via email o chat, dal lunedì al venerdì, dalle 9:00 alle 17:00 (ora della costa orientale USA, EST).