Översatt med AI. Gemenskapen har inte granskat översättningen än. Läs på engelska

Blogg · 7 september 2023 · Steve Simpson · Integration

Salesforce-tango: att förstå API-dansen mellan klienten och servern.

Introduktion

Här är insikter om samspelet mellan klient och server när du gör API-anrop i Salesforce, en avgörande del av vår integrationsserie på stevetecharc.com.

Salesforce-tangon: en dans av samspel

I API-anropens invecklade dans är det viktigt att förstå stegen. Diagrammet jag ska gå igenom visar dansstegen, alltså samspelet mellan klienten och servern.

Diagram: vad klienten och servern var för sig hanterar i ett API-anrop: plats, OAuth, protokoll, kontrakt, payload, spårning och felsökning, och fel

Serverns ansvar

Oavsett om Salesforce eller ett externt system är servern är ansvaret detsamma. Servern måste vara nåbar, ha en lyssnarprocess på en viss port (oftast 443 för SSL) och eventuellt ha en autentiseringsserver om OAuth används. Servern definierar protokollet, ger klienten de filer som behövs, bestämmer payloaden och kan spåra den inkommande payloaden och prestandan i den interna bearbetningen.

Klientens ansvar

Klienten måste känna till slutpunkten, hantera sessionstokens och vara beredd på fel när sessionen gått ut. Den måste anropa rätt protokoll, serialisera data korrekt och hantera returvärden. Klienten kan spåra utgående payloads och inkommande svar och hantera olika fel, medan ansvaret för att fånga och åtgärda de felen ligger hos servern.

Salesforce som server

Diagram: de Salesforce API som en extern klient kan anropa (SOAP, REST, Bulk, Apex SOAP och REST, Metadata, Tooling, Streaming och Pub/Sub) efter att ha autentiserat sig via en ansluten app och en integrationsanvändare

När Salesforce är servern kan det krävas en ansluten app, en integrationsprofil och en integrationsanvändare för OAuth-konfigurationen. Klienterna kan vara olika externa system som anropar Salesforce, med olika API:er och protokoll efter behov.

Salesforce som klient

Diagram: Salesforce som klient som anropar externa servrar: kopplingar till Marketing Cloud, Account Engagement och B2C Commerce, utgående Apex SOAP- och REST-anrop, External Services, utgående meddelanden, Salesforce Connect med OData, och Heroku Connect

Salesforce kan också vara klient och göra utgående anrop till externa servrar. Det kan innebära att importera WSDL-filer, generera Apex och sätta upp namngivna autentiseringsuppgifter för SOAP- och REST-servrar. Olika utgående mekanismer kräver olika konfigurationer, och alla följer de klient–server-protokoll som beskrevs tidigare.

Slutsats

Att förstå dansstegen i samspelet mellan klient och server i API-anrop till Salesforce är avgörande för att använda API:er effektivt. Vi har gått igenom ansvaret på båda sidor och tittat på scenarier med externa klienter och Salesforce i olika roller.

Håll utkik

För fler insikter och tips, håll utkik här på www.SteveTechArc.com och på YouTube-kanalen @SteveTechArc (opens in a new tab). Prenumerera och fördjupa din förståelse av Salesforce och hur du kan integrera det med andra system.

Vi hjälper till att förändra världen genom att dela integrationskunskap med andra arkitekter och med dem som är på väg att bli arkitekter!

Dyk ner i den tekniska buffén och fortsätt frossa i teknik. Förbli nördig!

Transkription med hjälp av AI

STA 1.3