-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Plantilla de artículo
Acerca de la API de Qualtrics
La API de Qualtrics se puede utilizar para automatizar procesos repetitivos en Qualtrics o para importar información a Qualtrics o exportarla. Por ejemplo, una Administrador de Marca/organización puede utilizar la API de Qualtrics para automatizar el proceso de creación de cuenta en lugar de crear cientos de cuentas individualmente. De manera similar, un usuario puede automatizar la creación de lista de contactos en lugar de compilarlas e importarlas manualmente. listas de contacto. Qualtrics también tiene varios Guías de soluciones API que puede ayudarle a determinar cuál es la mejor manera de utilizar la API para sus necesidades.
Acceso a la API para distintos productos
Qualtrics dispone de una variedad de productos que le permiten recopilar datos procesables en tiempo real. Algunos de estos productos incluyen Encuesta Platform, Site Intercept y XM Directory (Objetivo Audience). Una vez que haya adquirido la función API de Qualtrics, podrá usar la API para cualquier producto que forme parte de su licencia.
A continuación, se muestran los enlaces a la documentación de la versión más reciente de la API para cada uno de nuestros productos:
- Para conocer las API más recientes para la mayoría de los productos, consulte API de Qualtrics
- Site Intercept
Tenga en cuenta que siempre recomendamos que nuestros clientes utilicen la versión más reciente de la API.
Comprensión de la API de Qualtrics v3
La API de Qualtrics v3 es una API REST que le permite comunicarse con nuestro sistema o consultarlo mediante una sintaxis simple de URL. La comunicación con el sistema de Qualtrics se puede entender como una secuencia de solicitudes. Puede solicitar que la información se envíe a Qualtrics, se actualice, se borre o se devuelva a su sistema. Estas solicitudes se pueden realizar mediante solicitudes GET, POST, PUT o DELETE, que devuelven respuestas en formato JSON.
Con estos métodos, la API de Qualtrics le permite interactuar con partes del sistema de Qualtrics e integrar estas áreas con su CRM (plataforma de gestión de la relación con el cliente).
Preliminares
Parámetros de aprobación
Los parámetros constituyen los componentes de sus solicitudes. Todas las solicitudes de API requieren que se transfieran varios parámetros globales a Qualtrics, así como parámetros adicionales específicos de la solicitud y algunos opcionales.
Siempre tendrá que pasar el token de la API por la cabecera de la solicitud como X-API-TOKEN. En función de la solicitud específica que se esté ejecutando, es posible que deba pasar otros parámetros por la cabecera, por la URL o por el cuerpo de la solicitud. Al pasar parámetros por el cuerpo, deberá enviarlos como JSON. Cuando utilice este método, deberá especificar un tipo de contenido, es decir: application/json o multipart/form-data.
Ejemplo:En el siguiente ejemplo POST, en cURL especificamos la URL base, el tipo de contenido y el token en el encabezado. El ID de la Encuesta y el formato de exportación se especifican en el cuerpo.
curl -X POST -H 'X- API-TOKEN: yourapitokenhere' -H 'Tipo de contenido: aplicación/ json' -d '{
"identificador de encuesta": "SV_012345678912345",
"formato": "csv"
}' 'https: qualtrics.com/ API/v3/responseexports'
Generación de un token de API
Se requerirá un token de API para acceder a la API de Qualtrics. Cada usuario de una licencia debe generar su propio token de API. El token de API de su cuenta es necesario para autenticar cada solicitud API que cree. Se utiliza su token en lugar de la contraseña de su cuenta, lo cual ayuda a mejorar la seguridad de su trabajo. Para autenticarse, incluya su token bajo el encabezado HTTPS X- API-TOKEN.
Para generar un token de API
- Haga clic en el icono de configuración de usuario en la esquina superior derecha de su cuenta.
- Seleccionar Configuraciones de la Cuenta.
- Hacer clic Identificaciones de Qualtrics en la barra de navegación.
Atención: Se ha rediseñado la configuración de la Cuenta . Para ver los ID de Qualtrics , haga clic en Cambiar a una versión anterior.
- En el cuadro denominado API, haga clic en Generar token.
Creando un secreto de cliente
- Haga clic en el ícono de configuración de usuario en la esquina superior derecha de su cuenta de Qualtrics .
- Seleccionar Configuraciones de la Cuenta.
- Navegar a Identificaciones de Qualtrics.
Atención: Se ha rediseñado la configuración de la Cuenta . Para ver los ID de Qualtrics , haga clic en Cambiar a una versión anterior. - Elegir Gerente de clientes OAuth.
- Hacer clic Crear cliente.
- Introduzca un nombre de cliente.
- Si lo desea, introduzca una dirección de correo electrónico de contacto .
- Para Tipo de subvención, elegir Credenciales del cliente.
- Hacer clic Crear cliente.
- Escribe el Identificación del cliente y Secreto del cliente y guárdelos en un lugar seguro.
Atención: Una vez que salga de esta ventana, el secreto del cliente se mostrará. irreparable. Si pierde u olvida su secreto de cliente, deberá repetir el proceso anterior para generar uno nuevo.