Freigeben über

Die Ereignis-API im Outbound-Marketing verwenden

  • Artikel

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, sollten Sie vor diesem Datum zu Echtzeit-Journeys übergehen. Mehr Informationen: Überblick über den Ü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