Vertaald door AI. Nog niet door de community nagekeken. Lees in het Engels

Blog · 7 september 2023 · Steve Simpson · Integratie

Salesforce-tango: de API-dans tussen de client en de server begrijpen.

Inleiding

Hier zijn inzichten om de interacties tussen client en server te begrijpen bij API-aanroepen in Salesforce, een cruciaal aspect van onze integratiereeks op stevetechart.com.

De Salesforce-tango: een dans van interactie

In de ingewikkelde dans van API-aanroepen is het essentieel de passen te begrijpen. Het diagram dat ik ga bespreken, laat de danspassen of interacties tussen de client en de server zien.

Diagram: wat de client en de server elk afhandelen bij een API-aanroep: locatie, OAuth, protocol, contract, payload, tracing en debugging, en fouten

Verantwoordelijkheden aan de serverkant

Of Salesforce of een externe partij de server is, de verantwoordelijkheden blijven hetzelfde. De server moet bereikbaar zijn, een luisterproces hebben op een specifieke poort (meestal 443 voor SSL), en mogelijk een authenticatieserver hebben als OAuth gebruikt wordt. De server bepaalt het protocol, levert de nodige bestanden aan de client, beslist over de payload, en kan de binnenkomende payload en de prestaties van de interne verwerking tracen.

Verantwoordelijkheden aan de clientkant

De client moet het endpoint kennen, sessietokens afhandelen en voorbereid zijn op fouten door een verlopen sessie. Hij moet het juiste protocol aanroepen, data correct serialiseren en teruggegeven waarden afhandelen. De client kan uitgaande payloads en binnenkomende antwoorden tracen en verschillende fouten afhandelen, waarbij de verantwoordelijkheid om die fouten op te vangen en aan te pakken bij de server ligt.

Salesforce als server

Diagram: de Salesforce-API's die een externe client kan aanroepen (SOAP, REST, Bulk, Apex SOAP en REST, Metadata, Tooling, Streaming en Pub/Sub) na authenticatie via een connected app en een integratiegebruiker

Als Salesforce de server is, kan het een connected app, een integratieprofiel en een integratiegebruiker nodig hebben voor de OAuth-opzet. Clients kunnen allerlei externe partijen zijn die Salesforce aanroepen, met verschillende API’s en protocollen naar behoefte.

Salesforce als client

Diagram: Salesforce als client die externe servers aanroept: connectoren naar Marketing Cloud, Account Engagement en B2C Commerce, uitgaande Apex-callouts via SOAP en REST, External Services, outbound messages, Salesforce Connect met OData, en Heroku Connect

Salesforce kan ook client zijn en uitgaande aanroepen naar externe servers doen. Dat proces kan inhouden dat je WSDL-bestanden importeert, Apex genereert en named credentials opzet voor SOAP- en REST-servers. Voor verschillende uitgaande mechanismen zijn verschillende configuraties nodig, die elk de client-serverprotocollen volgen die eerder beschreven zijn.

Conclusie

De danspassen van client-serverinteracties bij Salesforce-API-aanroepen begrijpen is cruciaal voor efficiënt en effectief API-gebruik. We zijn ingegaan op de verantwoordelijkheden aan beide kanten en hebben scenario’s verkend met externe clients en Salesforce in verschillende rollen.

Blijf op de hoogte

Voor meer inzichten en tips: blijf op de hoogte hier op www.SteveTechArc.com en via het YouTube-kanaal @SteveTechArc (opens in a new tab). Abonneer je en verdiep je begrip van Salesforce en hoe je het met andere systemen kunt integreren.

De wereld helpen veranderen door integratiekennis te delen met collega-architecten en met iedereen die op weg is om architect te worden!

Duik diep in het technische buffet en blijf smullen van technologie. Blijf nerdy!

Transcript met hulp van AI

STA 1.3