Zdieľať cez

Používanie udalostí API

  • Článok

Poznámka

Od 1. septembra 2023 sa aplikácie Dynamics 365 Marketing a Dynamics 365 Customer Insights budú predávať spoločne v rámci jednej skladovej jednotky produktu s názvom Dynamics 365 Customer Insights. Jednotlivé aplikácie sa premenujú na Dynamics 365 Customer Insights – Činnosti a Dynamics 365 Customer Insights – Údaje (v tomto poradí). Ďalšie informácie nájdete v časti Najčastejšie otázky týkajúce sa aplikácie Dynamics 365 Customer Insights

Okrem toho 1. septembra 2023 noví zákazníci využívajúci aplikáciu Dynamics 365 Marketing získajú iba funkcie marketingu v reálnom čase. Ďalšie informácie nájdete v časti Predvolená inštalácia marketingu v reálnom čase. Mnohé stránky s dokumentáciou v súčasnosti odkazujú na funkcie odchádzajúceho marketingu, ktoré nemusia byť dostupné alebo môžu v marketingu v reálnom čase fungovať inak. Obsah dokumentácie bude aktualizovaný v septembri a bude informovať o tom, či sa vzťahuje na marketing v reálnom čase alebo odchádzajúci marketing.

Event API je programová metóda na prístup k údajom udalostí, relácií, stôp relácií, preukazov, rečníkov a sponzorstiev. Okrem toho vám umožňuje registrovať sa na podujatia a relácie.

Schéma

Prístup k API je cez protokol HTTPS a pristupuje sa k nemu z koncového bodu API, ktorý získate pri vytváraní tokenu webovej aplikácie. Všetky údaje sa odosielajú a prijímajú ako JSON.

Prázdne polia sú zahrnuté ako null a nie sú vynechané.

Koncový bod

Každý zákazník má svoju vlastnú URL koncového bodu. Webová adresa koncového bodu rozhrania Event API pozostáva z dvoch častí:

  • Doména koncového bodu
  • Podadresár

Koreňový koncový bod získate po vytvorení tokenu webovej aplikácie. Viac informácií o tom, ako vytvoriť token webovej aplikácie, nájdete tu: Zaregistrujte si webovú aplikáciu.

Príklad pre koreňový koncový bod

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com

Podadresár vždy začína EvtMgmt/api , za ktorým nasleduje verzia API (ktorú možno získať z dokumentácie API dostupnej tu: správa udalostí API reference docs.

Príklad pre podadresár

EvtMgmt/api/v2.0/

Príklad pre úplnú adresu URL koncového bodu

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

Overovanie

Ak chcete použiť rozhranie API udalostí, musíte v každej požiadavke zadať a web application token ako parameter adresy URL. Token webovej aplikácie sa používa na riadenie požiadaviek API, ktoré sú priradené k vašej organizácii. Ďalšie informácie o vytvorení a načítaní webovej aplikácie nájdete v časti Registrácia webovej aplikácie .

web application token je možné pridať do požiadavky pridaním parametra adresy URL s názvom emApplicationtoken.

Príklad

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

Okrem toho, pôvod, odkiaľ je požiadavka odoslaná, sa musí rovnať pôvodu zadanému pri vytváraní tokenu webovej aplikácie.

Ak neposkytnete token webovej aplikácie alebo hlavičku pôvodu, rozhranie API udalostí sa vráti HTTP 400 Bad Request.

Ak je token webovej aplikácie neplatný, rozhranie API udalostí vráti HTTP 401 Unauthorized.

Registrácia vašej webovej aplikácie

Ak chcete použiť rozhranie API udalostí, musíte v každej žiadosti poskytnúť token webovej aplikácie. Token webovej aplikácie sa používa na riadenie požiadaviek API, ktoré sú priradené k vašej organizácii. Viac informácií: Zaregistrujte svoju webovú aplikáciu