Passer au contenu principal
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Prise en main de 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!


À propos de l’API Qualtrics

L’API Qualtrics peut être utilisée pour automatiser des processus répétitifs au sein de Qualtrics ou pour transmettre des informations au sein et à l’extérieur de Qualtrics. Par exemple, un Administrateur d’entreprise peut utiliser l’API Qualtrics pour automatiser le processus de création de compte plutôt que de créer des centaines de comptes individuellement. De même, un utilisateur peut automatiser la création de listes de contacts plutôt que de compiler et d’importer manuellement des listes de contacts. Qualtrics propose également plusieurs guides de solution API qui peuvent vous aider à déterminer la meilleure façon d’utiliser l’API selon vos besoins.

Attention : l’implémentation d’extensions d’API peut nécessiter des connaissances en programmation. Notre équipe d’assistance ne pourra pas vous aider sur les sujets touchant au codage personnalisé. Vous pouvez plutôt tenter de vous adresser à notre communauté d’utilisateurs dédiés. Si vous souhaitez en savoir plus sur nos services de codage personnalisés, veuillez contacter votre Responsable de compte Qualtrics.

Accès API pour différents produits

Qualtrics propose différents produits vous permettant de collecter des données exploitables en temps réel. Certains de ces produits incluent la Plateforme d’enquête, Site Intercept et le Répertoire XM (Target Audience). Après avoir acheté la fonctionnalité API Qualtrics, vous pourrez l’utiliser avec tous les produits faisant partie de votre licence.

Voici des liens vers la documentation de la dernière version de l’API pour chacun de nos produits :

Veuillez noter que nous recommandons toujours à nos clients d’utiliser la dernière version de l’API.

Comprendre l’API Qualtrics v3

L’API Qualtrics v3 est une API REST qui vous permet de communiquer avec notre système ou de l’interroger à l’aide d’une syntaxe d’URL simple. La communication avec le système Qualtrics peut être considérée comme une séquence de demandes. Vous pouvez demander que des informations soient envoyées à Qualtrics, mises à jour, supprimées ou renvoyées vers votre système. Ces demandes peuvent être effectuées par des requêtes GET, POST, PUT ou DELETE qui renvoient des réponses JSON.

Ces méthodes permettent à l’API Qualtrics d’interagir avec des éléments du système Qualtrics et d’intégrer ces domaines à votre CRM.

Démarrer

Pour plus d’informations sur la prise en main de l’API Qualtrics, consultez Démarrage rapide de l’API Qualtrics.

Paramètres de passage

Les paramètres sont les éléments constitutifs de vos demandes. Chaque demande API nécessite la transmission de plusieurs paramètres globaux à Qualtrics, ainsi que de plusieurs paramètres spécifiques à la demande et de quelques paramètres facultatifs.

Vous devrez malgré tout transmettre le jeton API dans l’en-tête de la demande sous la forme X-API-JETON. En fonction de la demande spécifique en cours d’exécution, vous devrez peut-être transmettre d’autres paramètres dans l’en-tête, l’URL ou le corps de la demande. Lorsque vous transmettez des paramètres dans le corps, vous devez les envoyer au format JSON. Lorsque vous utilisez cette méthode, vous devez préciser un type de contenu (c’est-à-dire application/json ou multipart/form-data).

Exemple : dans l’exemple POST suivant, dans cURL, nous spécifions l’ URL de base, le type de contenu et le jeton dans l’en-tête. L’ID d’enquête et le format d’exportation sont indiqués dans
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"

Générer un jeton API

Un jeton API sera nécessaire pour accéder à l’API Qualtrics. Chaque utilisateur d’une licence doit générer son propre jeton API. Le jeton API de votre compte est requis pour authentifier chaque demande API que vous créez. Votre jeton est utilisé à la place du mot de passe de votre compte et contribue à renforcer la sécurité de votre travail. Pour vous authentifier, incluez votre jeton sous l’en-tête HTTPS X-API-TOKEN.

Astuce Qualtrics : pour générer un jeton, l’utilisateur doit disposer de l’autorisation d’accès à l’API pour son compte. Si votre organisation n’a pas accès à la fonctionnalité API Qualtrics, veuillez contacter votre Commercial Qualtrics pour plus d’informations.

Pour générer un jeton API

  1. Cliquez sur l’icône des paramètres utilisateur dans le coin supérieur droit de votre compte.
    Option Paramètres du compte dans le menu
  2. Sélectionnez Paramètres du compte.
  3. Cliquez sur ID Qualtrics dans la barre de navigation.
    navigation vers les ID qualtrics et clic sur Générer un jeton

    Attention : les paramètres du compte ont été repensés. Pour afficher les ID Qualtrics, cliquez sur Passer à l’ancienne version.bannière en haut de la page des paramètres du compte vous permettant de revenir à lancienne version
  4. Dans la zone API, cliquez sur Générer un jeton.
Avertissement : ne cliquez pas sur Générer un jeton si vous disposez déjà d’un jeton. Votre jeton API n’a besoin d’être généré qu’une seule fois. Si vous générez un nouveau jeton et que des extensions existantes utilisent l’ancien jeton, ces extensions existantes seront interrompues. La génération d’un nouveau jeton est irréversible. Il n’est pas possible de récupérer les anciens jetons.

Création d’une clé secrète client

  1. Cliquez sur l’icône des paramètres utilisateur dans le coin supérieur droit de votre compte Qualtrics.
    Option Paramètres du compte dans le menu
  2. Sélectionnez Paramètres du compte.
  3. Accédez aux ID Qualtrics.
    en accédant à la section oauth des ID Qualtrics et en cliquant sur Créer client ;

    Attention : les paramètres du compte ont été repensés. Pour afficher les ID Qualtrics, cliquez sur Passer à l’ancienne version.bannière en haut de la page des paramètres du compte vous permettant de revenir à lancienne version
  4. Sélectionnez Gestionnaire de clients OAuth.
  5. Cliquez sur Créer client.
  6. Saisissez un nom de client.
    Créer un client OAuth
  7. Si vous le souhaitez, saisissez une adresse e-mail de contact.
  8. Pour Type d’attribution, sélectionnez Identifiants client.
  9. Cliquez sur Créer client.
  10. Notez l’ ID client et la clé secrète client et enregistrez-les dans un lieu sécurisé.
    Identifiants client, ID client, clé secrète client

    Attention : une fois que vous quittez cette fenêtre, la clé secrète client est irrécupérable. Si vous perdez ou oubliez votre clé secrète client, vous devrez répéter le processus ci-dessus pour en générer un nouveau.
Astuce Qualtrics : pour en savoir plus sur la recherche de votre ID Qualtrics, consultez la section Trouver votre ID Qualtrics.

De nombreuses pages de ce site ont été traduites de l'anglais en traduction automatique. Chez Qualtrics, nous avons accompli notre devoir de diligence pour trouver les meilleures traductions automatiques possibles. Toutefois, le résultat ne peut pas être constamment parfait. Le texte original en anglais est considéré comme la version officielle, et toute discordance entre l'original et les traductions automatiques ne pourra être considérée comme juridiquement contraignante.