Die Ereignis-API im Outbound-Marketing verwenden
Anmerkung
Dynamics 365 Marketing und Dynamics 365 Customer Insights sind jetzt Customer Insights - Journeys und Customer Insights - Data. Weitere Informationen finden Sie in den FAQs zu Dynamics 365 Customer Insights
Neue Kunden von Customer Insights - Journeys erhalten ausschließlich Echtzeitmarketingfunktionen. Zusätzliche Informationen finden Sie in Echtzeitkontaktverläufe – Standardinstallation.
Wichtig
Dieser Artikel gilt nur für Outbound-Marketing, das am 30. Juni 2025 aus dem Produkt entfernt wird. Um Unterbrechungen zu vermeiden, stellen Sie vor diesem Datum auf Echtzeitfahrten um. Weitere Informationen: Übersicht zum Übergang
Die Ereignis-API ist eine programmgesteuerte Methode, um auf Daten von Ereignissen, Sitzungen, Veranstaltungsthemenbereichen, Eintrittsausweisen für Sitzungen, Sprechern und Sponsoren zuzugreifen. Darüber hinaus können Sie sich für Veranstaltungen und Sitzungen anmelden.
Schema
Der API-Zugriff erfolgt über das HTTPS-Protokoll und erfolgt über den API-Endpunkt, den Sie beim Erstellen eines Token für Webanwendungen erhalten. Alle Daten werden als JSON gesendet und empfangen.
Leere Felder werden als null
aufgenommen, anstatt weggelassen zu werden.
Endpunkt
Jeder Kunde hat seine eigene Endpunkt-URL. Die Endpunkt-URL der Event-API besteht aus zwei Teilen:
- Die Endpunktdomäne
- Das Unterverzeichnis
Sie erhalten den Root-Endpunkt, nachdem Sie ein Token für Webanwendungen erstellt haben. Weitere Informationen zum Erstellen eines Token für Webanwendungen finden Sie hier: Webanwendung registrieren.
Beispiel für Root-Endpunkt
https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com
Das Unterverzeichnis beginnt immer mit EvtMgmt/api
, gefolgt von der API-Version (die Sie der hier verfügbaren API-Dokumentation entnehmen können): Eventmanagement API Referenzdokumente.
Beispiel für ein Unterverzeichnis
EvtMgmt/api/v2.0/
Beispiel für eine vollständige Endpunkt-URL
https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/
Authentifizierung
Um die Ereignis-API zu verwenden, müssen Sie in jeder Anforderung einen web application token
als URL-Parameter angeben. Das Webanwendungstoken wird verwendet, um API-Anforderungen zu steuern, die mit Ihrer Organisation verknüpft sind. Weitere Informationen zum Erstellen und Abrufen einer Webanwendung finden Sie unter Webanwendung registrieren.
Sie können die web application token
auh dem Request hinzufügen, indem Sie einen URL-Parameter namens emApplicationtoken
verwenden.
Beispiel
https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/events/published?emApplicationtoken=B7vdzdhCiLt9c5iT….
Zusätzlich muss der Ursprung, von dem aus die Anforderung gesendet wird, gleich dem beim Erstellen des Token der Webanwendung angegebenen Ursprung sein.
Wenn Sie kein Webanwendungs-Token oder den Ursprungs-Header angeben, wird die Ereignis-API HTTP 400 Bad Request
zurückgeben.
Wenn das Token der Webanwendung ungültig ist, gibt die Ereignis-API HTTP 401 Unauthorized
zurück.
Registrieren Ihrer Webanwendung
Um die Ereignis-API verwenden zu können, müssen Sie in jeder Anforderung ein Webanwendungs-Token angeben. Das Webanwendungstoken wird verwendet, um API-Anforderungen zu steuern, die mit Ihrer Organisation verknüpft sind. Mehr Informationen: Registrieren Sie Ihre Webanwendung