Erste Schritte mit der Qualtrics-API

Suite
Customer Experience Employee Experience Strategy & Research
Produkt
Qualtrics

Was finden Sie hier?

Informationen zur Qualtrics-API

Mit der Qualtrics-API können Sie sich wiederholende Prozesse in Qualtrics automatisieren oder Informationen in und aus Qualtrics übergeben. Ein Administrator kann die Qualtrics-API zum Beispiel verwenden, um die Kontoerstellung zu automatisieren, anstatt Hunderte Benutzerkonten einzeln zu erstellen. Benutzer haben zudem die Möglichkeit, die Erstellung von Kontaktlisten zu automatisieren, anstatt Kontaktlisten manuell zusammenzustellen und zu importieren. Qualtrics verfügt auch über verschiedene API-Lösungsratgeber, anhand derer Sie bestimmen können, wie Sie die API am besten für Ihre Anforderungen einsetzen können.

Achtung: Die Implementierung von API-Erweiterungen erfordert möglicherweise Programmierkenntnisse. Unser Support-Team bietet keine Hilfe oder Beratung im Zusammenhang mit benutzerdefinierter Codeerstellung. Stattdessen können Sie sich immer an unsere engagierte Benutzer-Community wenden. Wenn Sie mehr über unsere Services für benutzerdefinierte Codeerstellung erfahren möchten, wenden Sie sich an Ihren Account Executive bei Qualtrics.

API-Zugriff für verschiedene Produkte

Qualtrics bietet eine Vielzahl verschiedener Produkte, mit denen Sie verwertbare Daten in Echtzeit erfassen können. Einige dieser Produkte enthalten die Umfrageplattform, Site Intercept und iQ Directory (Target Audience). Sobald Sie das Qualtrics-API-Merkmal erworben haben, können Sie sie für alle Produkte verwenden, die Teil Ihrer Lizenz sind.

Hier finden Sie Links zur Dokumentation der neuesten API-Version für jedes unserer Produkte:

Wir empfehlen unseren Kunden, immer die neueste Version der API zu verwenden.

Überblick über die Qualtrics v3-API

Die Qualtrics v3 API ist eine REST-API , mit der Sie über eine einfache URL-Syntax mit unserem System kommunizieren oder dieses abfragen können. Die Kommunikation mit dem Qualtrics-System können Sie sich als eine Abfolge von Anforderungen vorstellen. Sie können anfordern, dass Informationen an Qualtrics gesendet, aktualisiert, entfernt oder an das System zurückgegeben werden. Diese Anforderungen können Sie mit den Anforderungen GET, POST, PUT oder DELETE erstellen, die JSON-Antworten zurückgeben.

Auf diese Weise können Sie über die Qualtrics-API mit Teilen des Qualtrics-Systems interagieren und diese Bereiche in Ihr CRM integrieren.

Erste Schritte

Informationen zu den ersten Schritten mit der Qualtrics-API finden Sie unter Qualtrics-API-Schnellstart.

Übergebene Parameter

Parameter sind die Bausteine Ihrer Anforderungen. Bei jeder API-Anforderung müssen neben mehreren globalen Parametern auch anforderungsspezifischere sowie einige optionale Parameter an Qualtrics übergeben werden.

Sie müssen immer das API-Token über die Kopfzeile der Anforderung als X-API-TOKEN übergeben. Je nach ausgeführter Anforderung müssen Sie eventuell weitere Parameter über die Kopfzeile, die URL oder den Text der Anforderung übergeben. Bei der Übergabe von Parametern über den Text müssen Sie die Parameter als JSON senden. In diesem Fall müssen Sie einen Content-Typ (Anwendung/JSON oder Multipart/Form-Data) angeben.

Beispiel: Im folgenden POST-Beispiel geben wir in cURL die Basis-URL, den Content-Type und das Token im Header an. Die Umfrage-ID und das Exportformat werden im Body angegeben.
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'

Generieren eines API-Tokens

Für den Zugriff auf die Qualtrics-API ist ein API-Token erforderlich. Jeder Benutzer einer Lizenz muss sein eigenes API-Token generieren. Das API-Token Ihres Benutzerkontos ist erforderlich für die Authentifizierung jeder API-Anforderung, die Sie erstellen. Das Token wird anstelle Ihres Benutzerkontopassworts verwendet und steigert die Sicherheit Ihrer Arbeit. Fügen Sie Ihr Token zur Authentifizierung unter der HTTPS-Kopfzeile X-API-TOKEN ein.

Tipp: Um ein Token zu generieren, muss für das Konto des Benutzers die Berechtigung „Auf API zugreifen“ aktiviert sein. Wenn Ihre Organisation keinen Zugriff auf die Qualtrics-API-Funktion hat, wenden Sie sich bitte an Ihren Qualtrics Account Executive, um weitere Informationen zu erhalten.

Generieren eines API-Tokens

Tipp: Entwicklerinformationen zum Zugriff auf die Qualtrics-API finden Sie in der Entwicklerdokumentation.

Klicken Sie in der oberen rechten Ecke Ihres Kontos auf das Symbol für Benutzereinstellungen.
 

Wählen Sie Kontoeinstellungen.

Scrollen Sie nach unten zum Bereich „API“.

Achtung: Die „Kontoeinstellungen“ wurden neu gestaltet. Um Qualtrics-IDs anzuzeigen, klicken Sie auf „Zur älteren Version wechseln“.

Klicken Sie auf „Token generieren“.

Warnung: Klicken Sie nicht auf „Token generieren“, wenn Sie bereits ein Token haben. Ihr API-Token muss nur einmal generiert werden. Wenn Sie ein neues Token generieren und Sie bestehende Erweiterungen haben, die das alte Token verwenden, werden diese bestehenden Erweiterungen unterbrochen. Das Erstellen eines neuen Tokens kann nicht rückgängig gemacht werden und vorherige Token können nicht abgerufen werden.

Erstellen eines Kundengeheimnises

Klicken Sie auf das Symbol für die Benutzereinstellungen in der oberen rechten Ecke Ihres Qualtrics-Benutzerkontos.
Wählen Sie Kontoeinstellungen.
Navigieren Sie zu Qualtrics-IDs.
Attention: Account Settings has been redesigned. To view Qualtrics IDs, click Switch to older version.
Wählen Sie OAuth Kundenbetreuer.
Klicken Sie auf Kunden erstellen.
Geben Sie einen Namen des Kunden ein.
Falls gewünscht, geben Sie eine E-Mail-Adresse des Kontakts ein.
Wählen Sie für Genehmigungstyp Anmeldeinformationen aus.
Klicken Sie auf Kunden erstellen.
Notieren Sie die Kunden-ID und das Kundengeheimnis und speichern Sie beides an einem sicheren Ort.
Achtung: Sobald Sie dieses Fenster schließen, ist das Client-Secret nicht mehr abrufbar. Wenn Sie Ihr Kundengeheimnis verlieren oder vergessen, müssen Sie den obigen Prozess wiederholen, um ein neues zu generieren.

Tipp: Weitere Informationen zum Ermitteln Ihrer Qualtrics-ID finden Sie unter Ermitteln Ihrer Qualtrics-ID.

Model Context Protocol

Das Model Context Protocol (MCP) ist ein Open-Source-Standard zur Verbindung von KI-Anwendungen mit externen Systemen. Viele moderne KI-Anwendungen (z. B. ChatGPT, Claude, Cursor) nutzen MCP, um ihre Benutzer zu befähigen.

Qualtrics stellt einen MCP-Server für jede der APIs bereit, die auf unserer API-Website dokumentiert sind. Jeder Server stellt ein MCP-Tool für einen hier dokumentierten API-Endpunkt bereit. Jede JSON-basierte API wird unterstützt. Nicht-JSON-APIs werden derzeit nicht unterstützt.

Beispielsweise können Sie Qualtrics MCP verwenden, um KI-Agenten zu erstellen, die die Qualtrics-API nutzen, um Rücklaufquoten abzufragen, oder die Qualtrics-API verwenden, um Kundenkontakte in XM Directory zu aktualisieren. 

Sehen Sie sich den MCP-Leitfaden auf unserer API-Website an, um weitere Informationen zur Nutzung dieser Funktion zu erhalten. 

Viele Seiten dieses Portals wurden mithilfe maschineller Übersetzung aus dem Englischen übersetzt. Obwohl wir bei Qualtrics die bestmögliche maschinelle Übersetzung ausgewählt haben, um ein möglichst gutes Ergebnis zu bieten, ist maschinelle Übersetzung nie perfekt. Der englische Originaltext gilt als offizielle Version. Abweichungen zwischen dem englischen Originaltext und den maschinellen Übersetzungen sind nicht rechtlich bindend.

Hat Ihnen das weitergeholfen?

Das von Ihnen eingereichte Feedback, dient lediglich dazu, diese Seite zu verbessern.

Großartig! Vielen Dank für die Rückmeldung!

Vielen Dank für die Rückmeldung!