Modèle d’article

À propos des questions courantes sur l’API

Qualtrics dispose d’une variété de produits différents qui permettent à nos clients de recueillir des données exploitables en temps réel. Parmi ces produits figurent la Plateforme d’enquête, l’Avis site web/l’application, le Répertoire XM et Qualtrics 360. Après avoir acheté la fonctionnalité API Qualtrics, vous pourrez l’utiliser avec tous les produits faisant partie de votre licence.

• Documentation sur l’API pour la Plateforme Enquête et le Répertoire XM.
• Documentation API pour Avis sur site web/l’application.

Plateforme d’enquête

J’ai tous les paramètres corrects, mais je continue à recevoir un message d’erreur qui dit “Invalid request. Paramètre manquant ou invalide Demande” Pourquoi cela se produit-il ?

Exemple :

curl -X POST \N- https://yourdatacenterid.qualtrics.com/API/v3/responseexports \N- 
-H 'content-type : application/json' \N-H 'x-api-token : 12345678901234567890' \N- 
-d '{"surveyId" : "SV_1234567890", "Format" : "json"}'

Les paramètres de l’API Qualtrics sont sensibles à la casse. Dans cet exemple, votre paramètre est appelé “Format” alors qu’il devrait être “format” Mettez-le à jour et vous pourrez exécuter avec succès votre demande d’API.

Je voudrais télécharger mes données brutes pour les ouvrir dans Excel. Quelle demande d’API dois-je utiliser ?

Vous devez utiliser la demande Créer une exportation de réponses pour lancer le processus d’exportation et spécifier que le format du fichier d’exportation de réponses doit être CSV. Vous devrez ensuite utiliser la requête Get Response Export Progress pour vérifier si le fichier est prêt, puis la requête Get Response Export File pour télécharger votre fichier CSV.

Lors de l’utilisation de Create Contacts Import, quelles sont les différentes méthodes d’affichage ou d’envoi de ma liste de contacts à Qualtrics ?

Vous avez deux possibilités pour télécharger votre liste de contacts :

1. Vous pouvez définir le Content-Type sur multipart/form-data et télécharger vos contacts sous la forme d’un fichier JSON.
2. Vous pouvez définir le Content-Type sur application/json et envoyer les contacts sous la forme d’un tableau JSON dans le corps de la requête.

Suis-je limité dans le nombre de demandes que je peux faire pour mon organisation ? Et combien de demandes d’API simultanées puis-je effectuer ?

Voir cette page de l’API pour plus d’informations sur les limites.

J’utilise la demande d’importation d’une enquête et j’ai enregistré mon enquête sous la forme d’un fichier TXT. La demande est acceptée, mais mes questions n’apparaissent pas dans mon enquête nouvellement importée. Pourquoi cela se produit-il ?

Vous devez vous assurer que vous respectez le format nécessaire pour importer des enquêtes dans Qualtrics. Pour en savoir plus sur le formatage TXT, voir Préparation d’un fichier TXT au format simple et Préparation d’un fichier TXT au format avancé. Une fois que votre fichier est correctement formaté, la demande sera exécutée avec succès.

J’utilise la requête Create Response Export avec les paramètres startDate et endDate. Cependant, lorsque je regarde les données téléchargées, je ne vois pas la plage de dates prévue pour les réponses.

La clé de l’utilisation des paramètres startDate et endDate est de comprendre quelle valeur de date est utilisée pour évaluer la condition que vous créez (c’est-à-dire quelles dates sont prises en compte pour évaluer la startDate que vous avez définie et la endDate que vous avez définie). Ces deux paramètres utilisent la date à laquelle le participant a commencé l’Enquête. Cette valeur, appelée date de début, se trouve dans l’onglet Données et analyse et dans les données téléchargées. Ainsi, si vous définissez votre paramètre startDate sur 2017-01-01 et votre paramètre endDate sur 2017-01-02, vous téléchargerez les réponses enregistrées (soumises ou incomplètes) pour les participants à l’enquête qui ont commencé leur enquête dans la plage de dates comprise entre le 1er janvier 2017 et le 2 janvier 2017.

Astuce : Une réponse à une enquête n’est enregistrée que lorsque le participant clique sur le bouton “Soumettre” dans l’enquête ou lorsque le formulaire de réponse de l’enquête est rempli réponses à l’enquête incomplètes a été respecté.

Avis sur le site Web/l’application

Pour toute question sur le site web/l’avis application, contactez notre équipe d’assistance pour le site web/l’avis application.

Répertoire XM

Puis-je utiliser l’API de la Plateforme Enquête maintenant que j’utilise également le Répertoire XM ?

Oui, absolument. Le Répertoire XM comporte quelques requêtes API qui remplaceront les requêtes effectuées via l’API de la Plateforme d’Enquête, mais pour la plupart, vous pouvez toujours utiliser toutes les requêtes de l’API de la Plateforme d’Enquête. Les demandes de contacts de la plate-forme d’enquête sont les seules susceptibles d’être modifiées. Dans la documentation de la version 3, les demandes d’API qui ne sont pas prises en charge par les utilisateurs du Répertoire XM (et vice versa) seront signalées.

Quelles sont les fonctionnalités supplémentaires de l’API Répertoire XM auxquelles je n’ai pas accès avec l’API Plateforme Enquête ?

L’API du Répertoire XM vous propose quelques requêtes uniques spécifiques au Répertoire XM. Vous pouvez utiliser getBouncedContacts (API v2.4) pour trouver tous les contacts de votre répertoire (ou d’une liste de distribution spécifique) dont l’e-mail a été rejeté. La requête Liste de contacts du répertoire peut être utilisée pour exporter un sous-ensemble de votre répertoire entier. La requête getIncentiveRecipients vous permet de télécharger la liste de tous les contacts de votre répertoire qui ont obtenu une prime spécifique, telle qu’une récompense en points ou une participation à une loterie. Ces demandes et d’autres sont disponibles avec l’API du Répertoire XM.

Quelle est la différence entre l’ID du Contact et l’ID du Destinataire ?

Chaque requête de l’API Répertoire XM demande généralement l’ID du contact. Cet identifiant commence par “CID_” et est suivi d’une chaîne alphanumérique unique. L’ID du Contact est l’ID unique du contact dans votre répertoire. Certaines requêtes de l’API demandent l’identifiant du Destinataire du contact. Cet identifiant commence par “CGC_” et est suivi d’une chaîne alphanumérique unique. L’identifiant du destinataire est l’identifiant unique du contact dans une liste de distribution.

Pour comprendre la différence entre l’ID du Contact et l’ID du Destinataire, il est important de se rappeler que chaque contact ne doit exister qu’une seule fois dans votre répertoire. Ainsi, un même contact peut figurer une seule fois dans votre répertoire, mais il peut aussi être membre de plusieurs listes de distribution. Si ce contact était membre de trois listes de distribution, il aurait un ID de Contact et trois ID de Destinataire, un pour chaque liste.

Qualtrics 360

Pour toute question relative à Qualtrics 360, contactez notre équipe de support Qualtrics 360.