I team IT innovativi che utilizzano l’API Smartsheet vedono i vantaggi non appena la loro integrazione è attiva e funzionante. L’API è uno strumento potente per gli sviluppatori che aiuta a garantire una combinazione di gestione dei dati sicura, automazione mediante webhook e possibilità di rendere Smartsheet scalabile in tutta l’azienda.
Quindi, desideri creare un’integrazione utilizzando l’API Smartsheet ma non sai da dove iniziare? Segui questi cinque passaggi, descritti in dettaglio di seguito:
1. Esplora le risorse per gli sviluppatori
Il portale Smartsheet per gli sviluppatori è la “base di partenza” per tutte le risorse per sviluppatori. Qui troverai la documentazione API, le informazioni sugli SDK Smartsheet, le risposte alle tue domande specifiche sull’API dalla nostra community di utenti e altro ancora.
Per quanto possa essere allettante tuffarsi subito nella realizzazione della tua integrazione, dedicare anticipatamente tempo a rivedere queste risorse pagherà i dividendi lungo il percorso.
Dove trovare la documentazione API
Dopo aver guardato il video, visita la nostra pagina sulla documentazione API. Sia che tu stia pianificando di creare un’integrazione che chiami direttamente l’API Smartsheet o una che utilizzi un SDK Smartsheet, i documenti API contengono molte informazioni utili. Inizia familiarizzando con le seguenti sezioni:
Panoramica: un contesto di alto livello per lavorare con l’API Smartsheet
Per iniziare: informazioni di cui avrai bisogno per gettare le basi per la tua integrazione
Risoluzione dei problemi: fai un piano per risolvere i problemi quando rimani bloccato
SDK Smartsheet
I kit di sviluppo software (SDK) Smartsheet consentono di accedere all’API Smartsheet utilizzando il linguaggio di programmazione di tua scelta senza dover scrivere tutto il codice da zero. Oltre ai metodi predefiniti, ogni SDK include anche la logica di ripetizione dei tentativi (per gli errori di limite di velocità) e sistemi di registrazione.
Ogni rispettivo SDK (C#, Java, Node, Python, Ruby) include la documentazione e un foglio di lettura/scrittura di esempio disponibili per riferimento.
2. Completa la "Registrazione sviluppatore" (opzionale)
Dopo aver esplorato un po’ le nostre Risorse per sviluppatori Smartsheet, dovresti essere pronto a gettare le basi per creare la tua integrazione.
Crea un account sviluppatore
Se hai intenzione di creare un’applicazione di terze parti o se desideri creare un account Smartsheet sandbox che puoi usare per scopi di sviluppo e test (senza influire sui dati nel tuo account Smartsheet di produzione), dovrai completare il processo di registrazione sviluppatore.
3. Genera un token di accesso
Successivamente, per autenticare le richieste API tramite Accesso API diretto, è necessario un token di accesso API di proprietà dell’account Smartsheet a cui desideri accedere. I token di accesso possono essere generati dall’interfaccia utente di Smartsheet: accedi semplicemente al tuo account Smartsheet, quindi segui le istruzioni qui per generare un token.
Se stai creando un’applicazione di terze parti che implementerà il flusso OAuth2 per recuperare un token di accesso che può essere utilizzato per accedere ai dati Smartsheet per conto di un utente finale, non dovrai generare manualmente un token di accesso come descritto in precedenza. Consulta invece la documentazione API per informazioni sullo sviluppo di app di terze parti.
Se stai creando un’applicazione di terze parti destinata ad altri utenti, dovrai implementare un flusso OAuth2 per recuperare un token di accesso. La generazione automatica (piuttosto che manuale) di un token di accesso assicura che l’utente disponga del proprio token per accedere ai propri dati Smartsheet. Ti consigliamo di consultare la sezione della documentazione API sullo sviluppo di app di terze parti. Come riferimento, abbiamo un tutorial su come creare un flusso OAuth Smartsheet in Node.js.
4. Inizia a realizzare la tua integrazione
Il processo di creazione dell’integrazione varia a seconda che tu scelga o meno di usare un SDK. Entrambi gli approcci sono descritti in dettaglio di seguito:
Utilizzo di un SDK
Per utilizzare un SDK come base per l’integrazione, installa l’SDK di tua scelta seguendo le istruzioni fornite per il rispettivo SDK. Quindi, sfrutta la documentazione API per gli esempi di codice e procedi come segue:
Utilizzando il pannello di esempio di codice sul lato destro della pagina, seleziona la scheda relativa alla lingua desiderata.
Esamina il file readme e l’esempio di lettura/scrittura dei rispettivi SDK. Tutti i link sono disponibili sul Portale Smartsheet per gli sviluppatori.
Passa a una qualsiasi sezione Riferimento API per visualizzare un esempio di codice che illustra come eseguire l’operazione utilizzando l’SDK.
Senza un SDK
Sebbene tu possa trarre vantaggio dall’utilizzo di un SDK, non è affatto obbligatorio. Se scegli di rinunciare all’uso di un SDK a favore della creazione di un’integrazione personalizzata da zero, sfrutta la documentazione API come risorsa principale. Se rimani bloccato, non esitare a fare domande su StackOverflow utilizzando il tag smartsheet-api. La tua domanda potrebbe aiutare qualcuno in futuro.
5. Chiedi assistenza a Smartsheet
Potresti riscontrare un problema relativo all’API o all’SDK che non riesci a risolvere utilizzando la nostra guida alla risoluzione dei problemi relativi alle API oppure avere una domanda che non viene affrontata nei documenti API. Invia il tuo problema o la tua domanda a StackOverflow, dove noi (insieme a migliaia di sviluppatori in tutto il mondo) saremo pronti ad aiutarti.
Hai un feedback sull’API o vuoi suggerire nuove funzionalità dell’API? Contattaci all’indirizzo DevRel@smartsheet.com.
Scopri altre risorse
Quando si utilizza una nuova API per la prima volta c’è una curva di apprendimento, ma le risorse e i processi adeguati possono fare la differenza.
Ti incoraggiamo a sfruttare al massimo il Portale Smartsheet per gli sviluppatori per ottenere le risorse e le linee guida, con lo scopo di ridurre il tempo necessario per ottenere familiarità con l’API Smartsheet e implementare con sicurezza la tua soluzione.
Iscriviti alla Newsletter Smartsheet IT per ricevere suggerimenti, strategie e idee che possano aiutare i professionisti IT a essere più incisivi.
