Được dịch bằng AI. Cộng đồng chưa xem xét. Đọc bằng tiếng Anh

Blog · 7 tháng 9, 2023 · Steve Simpson · Tích hợp

Salesforce Tango: Hiểu điệu nhảy API giữa máy khách và máy chủ.

Giới thiệu

Đây là những góc nhìn giúp hiểu các tương tác giữa máy khách và máy chủ khi thực hiện lệnh gọi API trong Salesforce, một khía cạnh then chốt trong loạt bài tích hợp của chúng tôi trên stevetechart.com.

Salesforce Tango: một điệu nhảy của sự tương tác

Trong điệu nhảy phức tạp của các lệnh gọi API, hiểu các bước nhảy là điều thiết yếu. Sơ đồ tôi sắp thảo luận minh họa các bước nhảy, hay các tương tác, giữa máy khách và máy chủ.

Sơ đồ: những gì máy khách và máy chủ mỗi bên đảm nhận trong một lệnh gọi API: vị trí, OAuth, giao thức, hợp đồng, payload, truy vết và gỡ lỗi, và lỗi

Trách nhiệm phía máy chủ

Dù Salesforce hay một thực thể bên ngoài đóng vai trò máy chủ, các trách nhiệm vẫn như nhau. Máy chủ phải truy cập được, có một tiến trình lắng nghe trên một cổng cụ thể (thường là 443 cho SSL), và có thể có một máy chủ xác thực nếu dùng OAuth. Máy chủ định nghĩa giao thức, cung cấp các tệp cần thiết cho máy khách, quyết định payload, và có thể truy vết payload đi vào cũng như hiệu năng xử lý nội bộ.

Trách nhiệm phía máy khách

Máy khách phải biết endpoint, xử lý session token, và sẵn sàng cho các lỗi hết hạn phiên. Nó cần gọi đúng giao thức, tuần tự hóa dữ liệu chính xác và xử lý giá trị trả về. Máy khách có thể truy vết payload đi ra, phản hồi đi vào, và xử lý nhiều loại lỗi, với trách nhiệm bắt và giải quyết những lỗi này thuộc về máy chủ.

Salesforce là máy chủ

Sơ đồ: các API Salesforce mà một ứng dụng khách bên ngoài có thể gọi (SOAP, REST, Bulk, Apex SOAP và REST, Metadata, Tooling, Streaming và Pub/Sub) sau khi xác thực qua một connected app và một người dùng tích hợp

Khi Salesforce đóng vai trò máy chủ, nó có thể cần một connected app, một hồ sơ tích hợp và một người dùng tích hợp để thiết lập OAuth. Máy khách có thể là nhiều thực thể bên ngoài khác nhau thực hiện lệnh gọi vào Salesforce, dùng các API và giao thức khác nhau tùy theo nhu cầu.

Salesforce là máy khách

Sơ đồ: Salesforce là máy khách gọi đến các máy chủ bên ngoài: các trình kết nối đến Marketing Cloud, Account Engagement và B2C Commerce, các callout Apex SOAP và REST đi ra, External Services, outbound message, Salesforce Connect với OData, và Heroku Connect

Salesforce cũng có thể đóng vai trò máy khách, thực hiện các lệnh gọi đi ra đến máy chủ bên ngoài. Quá trình này có thể gồm việc nhập tệp WSDL, sinh code Apex, và thiết lập named credential cho các máy chủ SOAP và REST. Cần nhiều cấu hình khác nhau cho các cơ chế đi ra khác nhau, mỗi cơ chế đều tuân theo các giao thức máy khách-máy chủ đã mô tả ở trên.

Kết luận

Hiểu các bước nhảy của tương tác máy khách-máy chủ trong lệnh gọi API Salesforce là điều cốt yếu để dùng API hiệu quả. Chúng ta đã đi sâu vào trách nhiệm của cả hai phía và khám phá các tình huống liên quan đến máy khách bên ngoài và Salesforce trong những vai trò khác nhau.

Hãy đón xem

Để có thêm góc nhìn và mẹo hay, hãy theo dõi tại www.SteveTechArc.com và kênh YouTube @SteveTechArc (opens in a new tab). Hãy đăng ký và nâng cao hiểu biết của bạn về Salesforce và cách tích hợp nó với các hệ thống khác.

Góp phần thay đổi thế giới bằng cách chia sẻ kiến thức tích hợp với các kiến trúc sư đồng nghiệp và những ai đang trên hành trình trở thành kiến trúc sư!

Hãy lặn sâu vào bữa tiệc buffet công nghệ và tiếp tục thưởng thức công nghệ. Mãi là dân công nghệ nhé!

Bản ghi lời thoại được AI hỗ trợ

STA 1.3