Traduzido com IA. Ainda não revisto pela comunidade. Ler em inglês

Blog · 7 de setembro de 2023 · Steve Simpson · Integração

Tango do Salesforce: entender a dança da API entre cliente e servidor.

Introdução

Aqui encontra uma visão da interação entre cliente e servidor nas chamadas de API no Salesforce, um aspeto importante da nossa série de integração no stevetecharc.com.

O tango do Salesforce: uma dança de interação

Na dança complexa das chamadas de API, é preciso conhecer os passos. O diagrama que vou explicar mostra os passos da dança, ou seja, as interações entre cliente e servidor.

Diagrama: aquilo de que o cliente e o servidor tratam, cada um, numa chamada de API: localização, OAuth, protocolo, contrato, payload, rastreio e depuração, e erros

Responsabilidades do lado do servidor

Seja o Salesforce ou um sistema externo a atuar como servidor, as responsabilidades são as mesmas. O servidor tem de estar acessível, ter um processo à escuta numa porta específica (em geral 443 para SSL) e, possivelmente, um servidor de autenticação no caso do OAuth. O servidor define o protocolo, fornece ao cliente os ficheiros necessários, define o payload e pode rastrear o payload recebido e o desempenho do processamento interno.

Responsabilidades do lado do cliente

O cliente tem de conhecer o endpoint, gerir os tokens de sessão e estar preparado para erros de sessão expirada. Tem de chamar o protocolo certo, serializar os dados corretamente e tratar os valores de retorno. O cliente pode rastrear os payloads enviados e as respostas recebidas e tratar vários erros, embora a responsabilidade de capturar e corrigir esses erros seja do servidor.

O Salesforce como servidor

Diagrama: as APIs do Salesforce que um cliente externo pode chamar (SOAP, REST, Bulk, Apex SOAP e REST, Metadata, Tooling, Streaming e Pub/Sub) depois de se autenticar através de uma aplicação ligada e de um utilizador de integração

Quando o Salesforce atua como servidor, a configuração do OAuth pode exigir uma aplicação ligada, um perfil de integração e um utilizador de integração. Os clientes podem ser os mais variados sistemas externos, que chamam o Salesforce através de diferentes APIs e protocolos, conforme a necessidade.

O Salesforce como cliente

Diagrama: o Salesforce como cliente a chamar servidores externos: conectores para Marketing Cloud, Account Engagement e B2C Commerce, chamadas Apex SOAP e REST de saída, External Services, mensagens de saída, Salesforce Connect com OData e Heroku Connect

O Salesforce também pode atuar como cliente, fazendo chamadas de saída para servidores externos. Este processo pode envolver importar ficheiros WSDL, gerar Apex e configurar credenciais nomeadas para servidores SOAP e REST. Cada mecanismo de saída exige configurações próprias, e todos seguem os protocolos cliente-servidor descritos antes.

Conclusão

Entender os passos de dança da interação cliente-servidor nas chamadas de API do Salesforce é essencial para usar as APIs de forma eficiente e eficaz. Vimos as responsabilidades dos dois lados e explorámos cenários com clientes externos e com o Salesforce em diferentes papéis.

Fique atento

Para mais ideias e dicas, acompanhe aqui em www.SteveTechArc.com e no canal do YouTube @SteveTechArc (opens in a new tab). Subscreva e aprofunde o seu entendimento do Salesforce e de como integrá-lo com outros sistemas.

A ajudar a mudar o mundo, partilhando conhecimento sobre integração com outros arquitetos e com quem está na jornada para se tornar um!

Mergulhe fundo no bufete de tecnologia e continue a deliciar-se. Stay nerdy!

Transcrição feita com a ajuda de IA

STA 1.3