Traducido con IA. Aún no revisado por la comunidad. Leer en inglés

Blog · 7 de septiembre de 2023 · Steve Simpson · Integración

El tango de Salesforce: entender el baile de la API entre cliente y servidor.

Introducción

Aquí encontrarás una mirada a la interacción entre cliente y servidor en las llamadas a la API en Salesforce, un aspecto importante de nuestra serie de integración en stevetechart.com.

El tango de Salesforce: un baile de interacciones

En el complejo baile de las llamadas a la API, hay que conocer los pasos. El diagrama que voy a explicar muestra los pasos del baile, es decir, las interacciones entre cliente y servidor.

Diagrama: de qué se encarga cada uno, cliente y servidor, en una llamada a la API: ubicación, OAuth, protocolo, contrato, carga útil, rastreo y depuración, y errores

Responsabilidades del lado del servidor

Ya sea Salesforce o un sistema externo el que actúe como servidor, las responsabilidades son las mismas. El servidor debe ser accesible, tener un proceso de escucha en un puerto específico (normalmente el 443 para SSL) y, posiblemente, un servidor de autenticación en el caso de OAuth. El servidor define el protocolo, entrega al cliente los archivos necesarios, define la carga útil y puede rastrear la carga útil entrante y el rendimiento del procesamiento interno.

Responsabilidades del lado del cliente

El cliente debe conocer el endpoint, gestionar los tokens de sesión y estar preparado para errores por sesión vencida. Debe llamar al protocolo correcto, serializar bien los datos y manejar los valores de retorno. El cliente puede rastrear las cargas útiles salientes y las respuestas entrantes y manejar varios errores, aunque la responsabilidad de capturar y corregir esos errores es del servidor.

Salesforce como servidor

Diagrama: las API de Salesforce que un cliente externo puede llamar (SOAP, REST, Bulk, Apex SOAP y REST, Metadata, Tooling, Streaming y Pub/Sub) después de autenticarse mediante una aplicación conectada y un usuario de integración

Cuando Salesforce actúa como servidor, la configuración de OAuth puede requerir una aplicación conectada, un perfil de integración y un usuario de integración. Los clientes pueden ser los sistemas externos más variados, que llaman a Salesforce mediante distintas API y protocolos, según la necesidad.

Salesforce como cliente

Diagrama: Salesforce como cliente que llama a servidores externos: conectores a Marketing Cloud, Account Engagement y B2C Commerce, llamadas Apex SOAP y REST salientes, External Services, mensajes salientes, Salesforce Connect con OData y Heroku Connect

Salesforce también puede actuar como cliente y hacer llamadas salientes a servidores externos. Este proceso puede implicar importar archivos WSDL, generar Apex y configurar credenciales con nombre para servidores SOAP y REST. Cada mecanismo saliente necesita su propia configuración, y todos siguen los protocolos cliente-servidor descritos antes.

Conclusión

Entender los pasos de baile de la interacción cliente-servidor en las llamadas a la API de Salesforce es clave para usar las API de forma eficiente y eficaz. Repasamos las responsabilidades de ambos lados y exploramos escenarios con clientes externos y con Salesforce en distintos roles.

No te lo pierdas

Para más ideas y consejos, sigue atento aquí en www.SteveTechArc.com y en el canal de YouTube @SteveTechArc (opens in a new tab). Suscríbete y amplía tu comprensión de Salesforce y de cómo integrarlo con otros sistemas.

¡Ayudando a cambiar el mundo compartiendo conocimientos de integración con otros arquitectos y con quienes están en camino de serlo!

Sumérgete en el bufé tecnológico y sigue disfrutando. Stay nerdy!

Transcripción hecha con ayuda de IA

STA 1.3