Sử dụng API sự kiện
Lưu ý
Vào ngày 1 tháng 9 năm 2023, Dynamics 365 Marketing và Dynamics 365 Customer Insights sẽ được bán chung với một SKU sản phẩm duy nhất được gọi là Dynamics 365 Customer Insights. Các ứng dụng riêng lẻ sẽ được đổi tên tương ứng thành Dynamics 365 Customer Insights – Hành trình và Dynamics 365 Customer Insights – Dữ liệu. Để biết thêm thông tin, hãy xem Câu hỏi thường gặp về Dynamics 365 Customer Insights
Ngoài ra, vào ngày 1 tháng 9 năm 2023, các khách hàng mới của Dynamics 365 Marketing sẽ chỉ nhận các tính năng tiếp thị theo thời gian thực. Để biết thêm thông tin, hãy xem Cài đặt tiếp thị theo thời gian thực mặc định. Nhiều trang hướng dẫn sử dụng hiện đề cập đến các tính năng của tiếp thị truyền thống. Những tính năng này có thể không có sẵn hoặc sẽ khác khi hoạt động trong tiếp thị theo thời gian thực. Nội dung hướng dẫn sử dụng sẽ được cập nhật vào tháng 9 để lưu ý rằng nội dung này áp dụng cho tiếp thị theo thời gian thực hay tiếp thị truyền thống.
API sự kiện là một phương pháp có lập trình để truy cập dữ liệu về sự kiện, phiên, theo dõi phiên, thẻ, diễn giả và tài trợ. Ngoài ra, nó cho phép bạn đăng ký các sự kiện và phiên.
Sơ đồ
Quyền truy cập API qua giao thức HTTPS và được truy cập từ điểm cuối API mà bạn nhận được khi tạo mã thông báo ứng dụng web. Tất cả dữ liệu được gửi và nhận dưới dạng JSON.
Các trường trống được đưa vào dưới dạng null thay vì bị bỏ qua.
Điểm cuối
Mỗi khách hàng đều có URL điểm cuối của riêng họ. URL điểm cuối API sự kiện bao gồm hai phần:
- Miền điểm cuối
- Thư mục con
Bạn sẽ nhận được điểm cuối gốc sau khi tạo mã thông báo ứng dụng web. Bạn có thể tìm thêm thông tin về cách tạo mã thông báo ứng dụng web tại đây: Đăng ký ứng dụng web.
Ví dụ về điểm cuối gốc
https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com
Thư mục con luôn bắt đầu bằng EvtMgmt/api theo sau là phiên bản API (có thể truy xuất từ tài liệu API có sẵn tại đây: quản lý sự kiện Tài liệu tham khảo API.
Ví dụ về thư mục con
EvtMgmt/api/v2.0/
Ví dụ về URL điểm cuối đầy đủ
https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/
Xác thực
Để sử dụng API sự kiện, bạn cần cung cấp a web application token làm tham số URL trong mỗi yêu cầu. Mã thông báo ứng dụng web được sử dụng để kiểm soát các yêu cầu API được liên kết với tổ chức của bạn. Xem Đăng ký ứng dụng web để biết thêm thông tin về cách tạo và truy xuất ứng dụng web.
Bạn có thể thêm web application token vào yêu cầu bằng cách thêm tham số URL có tên là emApplicationtoken.
Ví dụ:
https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/events/published?emApplicationtoken=B7vdzdhCiLt9c5iT….
Ngoài ra, nguồn gốc nơi yêu cầu được gửi phải bằng nguồn gốc được chỉ định khi tạo mã thông báo ứng dụng web.
Nếu bạn không cung cấp mã thông báo ứng dụng web hoặc Tiêu đề gốc thì API sự kiện sẽ trả về HTTP 400 Bad Request.
Nếu mã thông báo ứng dụng web không hợp lệ thì API sự kiện sẽ trả về HTTP 401 Unauthorized.
Đăng ký ứng dụng web của bạn
Để sử dụng API sự kiện, bạn cần cung cấp mã thông báo ứng dụng web trong mỗi yêu cầu. Mã thông báo ứng dụng web được sử dụng để kiểm soát các yêu cầu API được liên kết với tổ chức của bạn. Thông tin thêm: Đăng ký ứng dụng web của bạn