Sie können OneTrust asynchron über ein veröffentlichtes Webformular oder eine externe Anwendung aufrufen, um dynamisch eine Anfrage zu erstellen, die in der Ansicht Webformularkonfiguration angezeigt wird.
Anmerkung
In dieser Dokumentation wird zum Testen von API-Integrationen das Tool „Postman“ verwendet.
Wählen Sie im Menü aus. Der Bildschirm Webformularvorlagen wird angezeigt.
-
Klicken Sie auf ein veröffentlichtes Webformular. Der Bildschirm Webformularanpassung wird angezeigt.
Anmerkung
Diese Funktion ist nur mit veröffentlichten Webformularen kompatibel. Weitere Informationen zum Erstellen neuer Webformulare finden Sie unter Erstellen eines Webformulars.
-
Wechseln Sie zur Registerkarte Integrieren, und klicken Sie dann auf die Registerkarte API.
-
Klicken Sie im Abschnitt Ihre API-URL auf die Schaltfläche URL kopieren.
Wählen Sie in Postman im Feld Endpoint die Option POST aus.
-
Fügen Sie Ihre API-URL im Feld URL ein.
-
Klicken Sie in OneTrust auf der Registerkarte API im Abschnitt Ihr API-Token auf die Schaltfläche Token kopieren.
Klicken Sie in Postman auf die Registerkarte Kopfzeilen.
Geben Sie im Feld KeyaccessToken ein.
-
Fügen Sie im Feld Value den API-Token aus OneTrust ein.
Die erwarteten Nutzdaten kopieren
-
Klicken Sie in OneTrust auf der Registerkarte API im Abschnitt Voraussichtliche Nutzlast auf die Schaltfläche Erwartete Nutzlast kopieren.
Anmerkung
Alle Änderungen an den Webformularfeldern führen zur dynamischen Aktualisierung der erwarteten Nutzdaten.
Klicken Sie in Postman auf die Registerkarte Body.
-
Aktivieren Sie als Vorschautyp raw.
Anmerkung
Stellen Sie sicher, dass der ausgewählte Dateityp JSON ist.
-
Fügen Sie unter „Body“ die erwarteten Nutzdaten ein.
Tipp
Sie können die Details einer Anfrage hinzufügen, indem Sie die Nutzdaten bearbeiten. Entfernen Sie alle zusätzlichen Parameter, die Sie nicht senden möchten, um die Anfrage zu erstellen, oder die undefinierte Werte („NULL“) aufweisen (z. B. keine Anhänge). Bei undefinierten Parameterwerten wird der Aufruf nicht gesendet.
Klicken Sie auf die Schaltfläche Senden.
-
Überprüfen Sie anhand des Statuscodes, ob der Aufruf gesendet wurde. Bei richtiger Ausführung sollte er einen Wert für requestTraceId zurückliefern.
Kopieren Sie die requestTraceId.
Die Anfrage in OneTrust verifizieren
Erstellen Sie einen weiteren Aufruf in Postman mit dem Endpunkt GET request status by Trace ID: GET /api/datasubject/v2/requestqueues/status/{traceId}
-
Hängen Sie die neu erstellte requestTraceID am Ende des Endpunkts an.
Geben Sie auf der Registerkarte Kopfzeile einen weiteren API-Schlüssel ein.
Klicken Sie auf die Schaltfläche Senden.
-
Wenn der Aufruf erfolgreich war, wird als Rückgabe creationstatus:SUCCESS und eine neue requestReId geliefert.
Kehren Sie zu OneTrust zurück, um zu schauen, ob die neu erstellte Anfrage mit der entsprechenden RequestReId in der Anfragewarteschlange angezeigt wird.
