Passa al contenuto principale
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Iniziare con l’API Qualtrics


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Informazioni sull’API Qualtrics

L’API Qualtrics può essere utilizzata per automatizzare i processi ripetitivi all’interno di Qualtrics o per trasmettere informazioni in entrata e in uscita da Qualtrics. Ad esempio, un Amministratore della licenza può utilizzare l’API Qualtrics per automatizzare il processo di creazione dell’account piuttosto che creare centinaia di account singolarmente. Analogamente, un utente può automatizzare la creazione dell’elenco dei contatti piuttosto che compilare e importare manualmente gli elenchi di contatti. Qualtrics dispone anche di varie guide alle soluzioni API che possono aiutarti a determinare il modo migliore per utilizzare l’API in base alle tue esigenze.

Attenzione: le estensioni API potrebbero richiedere conoscenze di programmazione da implementare. Il nostro team di supporto non offre assistenza o consulenza sulla codifica personalizzata. Puoi invece provare a domandare alla nostra community di utenti esperti. Se desideri maggiori informazioni sui nostri servizi di programmazione personalizzata, contatta il tuo Account Executive Qualtrics.

Accesso API per diversi prodotti

Qualtrics dispone di una varietà di prodotti diversi che ti consentono di raccogliere dati utilizzabili in tempo reale. Alcuni di questi prodotti includono la Survey Platform, Site Intercept e la XM Directory (Target Audience). Una volta acquistata la funzione API di Qualtrics, sarai in grado di utilizzarla per tutti i prodotti che fanno parte della tua licenza.

Di seguito sono riportati i collegamenti alla documentazione per la versione più recente dell’API per ogni prodotto:

Si consiglia sempre ai clienti di utilizzare la versione più recente dell’API.

Comprensione dell’API v3 di Qualtrics

L’API v3 di Qualtrics è una REST API che ti consente di comunicare o interrogare il nostro sistema utilizzando una semplice sintassi URL. La comunicazione con il sistema Qualtrics può essere pensata come una sequenza di richieste. Puoi richiedere informazioni da inviare a Qualtrics, aggiornarle, rimuoverle o restituirle al tuo sistema. Queste richieste possono essere effettuate da richieste GET, POST, PUT o DELETE che restituiscono risposte JSON.

Attraverso questi mezzi, l’API Qualtrics ti consente di interagire con parti del sistema Qualtrics e integrare queste aree con il tuo CRM.

Iniziare ora

Per informazioni su come iniziare a utilizzare le API di Qualtrics, consultare Qualtrics API Quickstart.

Parametri di trasmissione

I parametri sono i moduli per le richieste dell’utente. Ogni richiesta API richiede la trasmissione di diversi parametri globali a Qualtrics, oltre a più parametri specifici della richiesta e alcuni facoltativi.

Sarà sempre necessario trasferire il token API attraverso l’intestazione della richiesta come X-API-TOKEN. A seconda della specifica richiesta in esecuzione, potrebbe essere necessario passare altri parametri attraverso l’intestazione, l’URL o il corpo della richiesta. Quando si trasferiscono i parametri nel corpo, è necessario inviarli come JSON. Quando si utilizza questo metodo, è necessario specificare un Content-Type (ad es. application/json o multipart/form-data).

Esempio: nel seguente esempio POST, in cURL si specifica l’URL base, il Content-Type e il Token nell’intestazione. L’ID indagine e il formato dell’esportazione sono specificati in
body.curl -X POST -H 'X-API-TOKEN: yourapitokenhere' -H 'Content-Type: application/json' -d '{
   "SurveyId": "SV_012345678912345",
   "format": "csv"
}' 'https://yourdatacenterid.qualtrics.com/API/v3/responseexports'

Generazione di un token API

Sarà richiesto un token API per accedere all’API Qualtrics. Ogni utente in una licenza deve generare il proprio token API. Il token API del proprio account è richiesto per autenticare ogni richiesta API creata. Il token viene utilizzato al posto della password dell’account e contribuisce a migliorare la sicurezza del lavoro. Per eseguire l’autenticazione, includere il token nell’intestazione HTTPS X-API-TOKEN.

Qtip: per generare un token, l’utente deve disporre dell’autorizzazione Accesso API abilitata per il proprio account. Se la tua organizzazione non ha accesso alla funzione API Qualtrics, contatta il tuo Account Executive Qualtrics per maggiori informazioni.

Generazione di un token API

  1. Fare clic sull’icona delle impostazioni utente nell’angolo in alto a destra dell’account.
    Opzione Impostazioni account nel menu
  2. Seleziona Impostazioni account.
  3. Fai clic su ID Qualtrics sulla barra di navigazione.
    Navigazione agli ID Qualtrics e clic su Genera token

    Attenzione: le impostazioni dell’account sono state riprogettate. Per visualizzare gli ID Qualtrics, fate clic su Passa alla versione precedente.banner in cima alla pagina delle impostazioni dellaccount che consente di tornare alla versione precedente
  4. Nella casella API con etichetta, fare clic su Genera token.
Avvertimento: non fare clic su Genera token se si dispone già di un token. Il token API deve essere generato una sola volta. Se si genera un nuovo token e si dispone di estensioni esistenti che utilizzano il token precedente, gli ampliamenti esistenti verranno interrotti. La generazione di un nuovo token è irreversibile; non è possibile recuperare i token precedenti.

Creazione di una chiave client segreta

  1. Fai clic sull’icona delle impostazioni utente nell’angolo in alto a destra del tuo account Qualtrics.
    Opzione Impostazioni account nel menu
  2. Seleziona Impostazioni account.
  3. Vai agli ID Qualtrics.
    passando alla sezione OAuth degli ID Qualtrics e facendo clic su Crea client

    Attenzione: le impostazioni dell’account sono state riprogettate. Per visualizzare gli ID Qualtrics, fate clic su Passa alla versione precedente.banner in cima alla pagina delle impostazioni dellaccount che consente di tornare alla versione precedente
  4. Selezionare Gestione client OAuth.
  5. Fare clic su Crea client.
  6. Inserisci un nome client.
    Crea un nuovo client OAuth
  7. Se lo si desidera, inserire un indirizzo di posta elettronica del contatto.
  8. Per Concedi tipo, selezionare Credenziali client.
  9. Fare clic su Crea client.
  10. Annotare l’ID client e la chiave client segreta e archiviarli in un’ubicazione sicura.
    Credenziali client, ID client, chiave client segreta

    Attenzione: una volta usciti da questa finestra, la Chiave segreta client è irrecuperabile. Se si perde o si dimentica la chiave client segreta, sarà necessario ripetere il processo precedente per generarne uno nuovo.
Suggerimento: per maggiori informazioni su come trovare il tuo ID Qualtrics, consulta Trovare il tuo ID Qualtrics.

Molte delle pagine di questo sito sono state tradotte dall'originale in inglese mediante traduzione automatica. Sebbene in Qualtrics abbiamo profuso il massimo impegno per avere le migliori traduzioni automatiche possibili, queste non sono mai perfette. Il testo originale inglese è considerato la versione ufficiale, e qualsiasi discrepanza tra questo e le traduzioni automatiche non è legalmente vincolante.