Оқиғалар API пайдалану

Ескертпе

2023 жылдың 1 қыркүйегінде Dynamics 365 Marketing және Dynamics 365 Customer Insights бір өнім SKU деп аталатын бірге сатылады Dynamics 365 Customer Insights. Жеке қолданбалардың атауы тиісінше Dynamics 365 Customer Insights - Саяхаттар және Dynamics 365 Customer Insights - Деректер деп өзгертіледі. Қосымша ақпаратты Dynamics 365 Customer Insights ЖҚС қараңыз

Сонымен қатар, 2023 жылдың 1 қыркүйегінде жаңа Dynamics 365 Marketing тұтынушылары нақты уақыттағы маркетинг мүмкіндіктерін ғана алады. Қосымша ақпарат алу үшін Әдепкі нақты уақыттағы маркетинг орнатуын қараңыз. Көптеген құжаттама беттері қазіргі уақытта қол жетімді болмауы мүмкін немесе нақты уақыттағы маркетингте басқаша жұмыс істеуі мүмкін шығыс мүмкіндіктерге сілтеме жасайды. Құжаттама мазмұны оның нақты уақыттағы немесе шығыс маркетингке қатысты екенін ескеру үшін қыркүйек айында жаңартылады.

Оқиғалар API - оқиғалардың, сеанстардың, сеанс тректерінің, өтулердің, спикерлердің және демеушіліктердің деректеріне қол жеткізудің бағдарламалық әдісі. Бұған қоса, ол оқиғалар мен сеанстарға тіркелуге мүмкіндік береді.

Схема

API қатынасы HTTPS протоколы арқылы жүзеге асырылады және веб-бағдарлама таңбалауышын жасау кезінде алатын API соңғы нүктесінен қол жеткізіледі. Барлық деректер JSON ретінде жіберіледі және қабылданады.

Бос өрістер түсірілудің орнына null деп қосылады.

Соңғы нүкте

Әрбір тұтынушының өзінің соңғы URL URL мекенжайы бар. Event API соңғы нүктесінің URL мекенжайы екі бөліктен тұрады:

• Соңғы нүкте домені
• Ішкі каталог

Веб қолданбасының таңбалауышын жасағаннан кейін түбірлік соңғы нүктені аласыз. Веб қолданба таңбалауышын жасау жолы туралы қосымша ақпаратты мына жерден таба аласыз: Веб қолданбасын тіркеу.

Түбірлік соңғы нүктеге мысал

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 пайдалану үшін әрбір сұрауда URL параметрі ретінде web application token беру қажет. Веб қолданба таңбалауышы ұйымыңызбен байланысты API сұрауларын басқару үшін пайдаланылады. Веб қолданбаны жасау және шығарып алу туралы қосымша ақпаратты веб қолданбасын тіркеу бөлімінен қараңыз.

web application token сұранысқа emApplicationtoken деп аталатын URL параметрін қосу арқылы қосуға болады.

Мысал

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

Сонымен қатар, сұрау жіберілген жердегі бастапқы деректеме веб-бағдарлама таңбалауышын жасау кезінде көрсетілген бастауға тең болуы керек.

Веб қолданбасының таңбалауышын немесе Түпнұсқа тақырыбын бермесеңіз, оқиғалар API HTTP 400 Bad Request қайтарады.

Веб қолданбасының таңбалауышы жарамсыз болса, оқиғалар API HTTP 401 Unauthorized қайтарады.

Веб қолданбаңызды тіркеңіз

Оқиғалар API пайдалану үшін әрбір сұрауда веб-бағдарлама таңбалауышын қамтамасыз ету қажет. Веб қолданба таңбалауышы ұйымыңызбен байланысты API сұрауларын басқару үшін пайдаланылады. Қосымша ақпарат: Веб қолданбаңызды тіркеңіз