由 AI 翻譯,尚未經過社群審閱。 閱讀英文版

部落格 · 2023年9月7日 · Steve Simpson · 整合

Salesforce 探戈:理解用戶端與伺服器之間的 API 之舞。

引言

在這裡,你會了解到 Salesforce 中 API 呼叫裡用戶端與伺服器之間的互動,這是我們在 stevetechart.com 上的整合系列的一個重要方面。

Salesforce 探戈:一場互動之舞

在 API 呼叫這場複雜的舞蹈中,你必須知道舞步。我接下來要講解的這張圖,展示的就是舞步,也就是用戶端與伺服器之間的互動。

圖示:一次 API 呼叫中用戶端和伺服器各自負責的事情:位置、OAuth、協議、契約、載荷、追蹤與除錯,以及錯誤

伺服器端的職責

無論充當伺服器的是 Salesforce 還是某個外部系統,職責都是一樣的。伺服器必須可以存取,在特定埠上有一個監聽程序(使用 SSL 時通常是 443),在使用 OAuth 時可能還需要一個認證伺服器。伺服器定義協議,向用戶端提供必要的檔案,定義載荷,並且可以追蹤傳入的載荷以及內部處理的效能。

用戶端的職責

用戶端必須知道端點,管理工作階段權杖,併為工作階段過期導致的錯誤做好準備。它必須呼叫正確的協議,正確地序列化資料,並處理返回值。用戶端可以追蹤發出的載荷和收到的響應,並處理各種錯誤,不過捕獲和修復這些錯誤的責任在伺服器一方。

Salesforce 作為伺服器

圖示:外部用戶端在通過連線應用程式和整合使用者認證後可以呼叫的 Salesforce API(SOAP、REST、Bulk、Apex SOAP 和 REST、Metadata、Tooling、Streaming 以及 Pub/Sub)

當 Salesforce 充當伺服器時,OAuth 的設定可能需要一個連線應用程式、一個整合設定檔和一個整合使用者。用戶端可以是各種各樣的外部系統,根據需要通過不同的 API 和協議呼叫 Salesforce。

Salesforce 作為用戶端

圖示:Salesforce 作為用戶端呼叫外部伺服器:通往 Marketing Cloud、Account Engagement 和 B2C Commerce 的聯結器,出站的 Apex SOAP 和 REST 外部呼叫,External Services,出站訊息,使用 OData 的 Salesforce Connect,以及 Heroku Connect

Salesforce 也可以充當用戶端,向外部伺服器發起出站呼叫。這個過程可能涉及匯入 WSDL 檔案、生成 Apex,以及為 SOAP 和 REST 伺服器設定命名憑據。不同的出站機制需要不同的配置,每一種都遵循前面描述的用戶端-伺服器協議。

結論

理解 Salesforce API 呼叫中用戶端與伺服器互動的舞步,對於高效、有效地使用 API 至關重要。我們深入探討了雙方的職責,並研究了外部用戶端以及 Salesforce 扮演不同角色的各種場景。

敬請關注

想獲得更多見解和技巧,請繼續關注 www.SteveTechArc.com 和 YouTube 頻道 @SteveTechArc (opens in a new tab)。訂閱,加深你對 Salesforce 以及如何將它與其他系統整合的理解。

與架構師同行以及正走在架構師之路上的人分享整合知識,一起改變世界!

深入品嚐這場技術自助餐,繼續盡情享用技術吧。Stay nerdy!

轉錄藉助了 AI

STA 1.3