Използване на API за събития

Бележка

От 1 септември 2023 г. Dynamics 365 Marketing и Dynamics 365 Customer Insights ще се продават заедно в обща SKU на продукт, наречен Dynamics 365 Customer Insights. Отделните приложения ще бъдат преименувани съответно на Dynamics 365 Customer Insights – Пътешествия и Dynamics 365 Customer Insights – Данни. За повече информация вижте ЧЗВ за Dynamics 365 Customer Insights

Освен това от 1 септември 2023 г. новите клиенти на Dynamics 365 Marketing ще получават само функциите за маркетинг в реално време. За повече информация вижте Инсталация за маркетинг в реално време по подразбиране. Много страници с документация в момента се отнасят до функции за изходящ маркетинг, които може да не са налични или да работят по различен начин при маркетинг в реално време. Съдържанието на документацията ще бъде актуализирано през септември, за да се отбележи дали се отнася за маркетинг в реално време, или за изходящ маркетинг.

API за събития е програмен метод за достъп до данни за събития, сесии, песни за сесии, пропуски, говорители и спонсорства. Освен това ви позволява да се регистрирате за събития и сесии.

Схема

Достъпът до API е през HTTPS протокол и е достъпен от крайната точка на API, която получавате, докато създавате маркер за уеб приложение. Всички данни се изпращат и получават като JSON.

Празните полета се включват като null , вместо да се пропускат.

Крайна точка

Всеки клиент има свой собствен URL адрес на крайна точка. URL адресът на крайната точка на API за събития се състои от две части:

• Домейнът на крайната точка
• Поддиректорията

Ще получите коренната крайна точка след създаване на маркер за уеб приложение. Можете да намерите повече информация за това как да създадете маркер за уеб приложение тук: Регистрирайте уеб приложение.

Пример за коренна крайна точка

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com 

Поддиректорията винаги започва с EvtMgmt/api последвана от версията на API (която може да бъде извлечена от документацията на API, достъпна тук: управление на събитие API референтни документи.

Пример за поддиректория

EvtMgmt/api/v2.0/ 

Пример за URL адрес на пълна крайна точка

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/ 

Удостоверяване

За да използвате API за събития, трябва да предоставите като web application token URL параметър във всяка заявка. Маркерът на уеб приложение се използва за управление на заявки за API, които са свързани с вашата организация. Вижте Регистриране на уеб приложение за повече информация как да създадете и извлечете уеб приложение .

Към web application token заявката може да се добави чрез добавяне на извикан URL параметър emApplicationtoken.

Пример

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/events/published?emApplicationtoken=B7vdzdhCiLt9c5iT….

Освен това произходът, от който се изпраща заявката, трябва да е равен на произхода, посочен при създаването на маркера на уеб приложението.

Ако не предоставите маркер за уеб приложение или заглавката на произхода, API за събития ще се върне HTTP 400 Bad Request.

Ако маркерът на уеб приложението е невалиден, API за събития ще се върне HTTP 401 Unauthorized.

Регистриране на уеб приложението ви

За да използвате API за събития, трябва да предоставите маркер за уеб приложение във всяка заявка. Маркерът на уеб приложение се използва за управление на заявки за API, които са свързани с вашата организация. Повече информация: Регистрирайте вашето уеб приложение