Compartir por

Uso da API de eventos

  • Artigo

Nota

O 1 de setembro de 2023, Dynamics 365 Marketing e Dynamics 365 Customer Insights venderanse xuntos cun único SKU de produto chamado Dynamics 365 Customer Insights. As aplicacións individuais pasarán a chamarse Dynamics 365 Customer Insights - Viaxes e Dynamics 365 Customer Insights - Datos, respectivamente. Para obter máis información, consulte as Preguntas frecuentes de Dynamics 365 Customer Insights

Ademais, o 1 de setembro de 2023, os novos clientes de Dynamics 365 Marketing recibirán só nas funcións de márketing en tempo real. Para obter máis información, consulte Instalación predefinida de márketing en tempo real. Actualmente, moitas páxinas de documentación fan referencia a funcións de saída que poden non estar dispoñibles ou poden funcionar de forma diferente en márketing en tempo real. O contido da documentación actualizarase en setembro para indicar se se aplica a márketing en tempo real ou de saída.

A API de eventos é un método programático para acceder a datos de eventos, sesións, pistas de sesións, pases, oradores e patrocinios. Ademais, permíteche rexistrarte para eventos e sesións.

Esquema

O acceso á API realízase mediante o protocolo HTTPS e accédese desde o punto final da API que recibe ao crear un token de aplicación web. Todos os datos envíanse e reciben como JSON.

Os campos en branco inclúense como null en lugar de omitirse.

Extremo

Cada cliente ten o seu propio URL de punto final. O URL do punto final da API do evento consta de dúas partes:

  • O dominio do punto final
  • O subdirectorio

Recibirá o punto final raíz despois de crear un token de aplicación web. Podes atopar máis información sobre como crear un token de aplicación web aquí: Rexistrar aplicación web.

Exemplo de punto final raíz

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com

O subdirectorio comeza sempre con EvtMgmt/api seguido da versión da API (que se pode recuperar da documentación da API dispoñible aquí: xestión de eventos API docs de referencia.

Exemplo de subdirectorio

EvtMgmt/api/v2.0/

Exemplo de URL de punto final completo

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

Autenticación

Para utilizar a API de eventos, cómpre proporcionar a web application token como parámetro de URL en cada solicitude. O token da aplicación web úsase para controlar as solicitudes de API asociadas á túa organización. Consulta Rexistrar aplicación web para obter máis información sobre como crear e recuperar unha aplicación web.

O web application token pódese engadir á solicitude engadindo un parámetro URL chamado emApplicationtoken.

Exemplo

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

Ademais, a orixe desde onde se envía a solicitude debe ser igual á orixe especificada ao crear o token da aplicación web.

Se non proporcionas un token de aplicación web nin a cabeceira de orixe, a API de eventos devolverá HTTP 400 Bad Request.

Se o token da aplicación web non é válido, a API de eventos devolverá HTTP 401 Unauthorized.

Rexistrar a súa aplicación web

Para usar a API de eventos, cómpre proporcionar un token de aplicación web en cada solicitude. O token da aplicación web úsase para controlar as solicitudes de API asociadas á túa organización. Máis información: Rexistra a túa aplicación web