Oversat med AI. Fællesskabet har endnu ikke gennemgået oversættelsen. Læs på engelsk

Blog · 7. september 2023 · Steve Simpson · Integration

Salesforce-tango: forstå API-dansen mellem klienten og serveren.

Introduktion

Her er indsigter i samspillet mellem klient og server, når du laver API-kald i Salesforce, en afgørende del af vores integrationsserie på stevetecharc.com.

Salesforce-tangoen: en dans af samspil

I API-kaldenes indviklede dans er det vigtigt at forstå trinene. Diagrammet, jeg skal gennemgå, viser dansetrinene, altså samspillet mellem klienten og serveren.

Diagram: hvad klienten og serveren hver især håndterer i et API-kald: placering, OAuth, protokol, kontrakt, payload, sporing og fejlfinding samt fejl

Serverens ansvar

Uanset om Salesforce eller et eksternt system er serveren, er ansvaret det samme. Serveren skal være tilgængelig, have en lytteproces på en bestemt port (typisk 443 for SSL) og eventuelt have en autentificeringsserver, hvis OAuth bruges. Serveren definerer protokollen, giver klienten de nødvendige filer, bestemmer payloaden og kan spore den indgående payload og ydeevnen i den interne behandling.

Klientens ansvar

Klienten skal kende endpointet, håndtere sessionstokens og være forberedt på fejl, når sessionen er udløbet. Den skal kalde den rigtige protokol, serialisere data korrekt og håndtere returværdier. Klienten kan spore udgående payloads og indgående svar og håndtere forskellige fejl, mens ansvaret for at fange og afhjælpe disse fejl ligger hos serveren.

Salesforce som server

Diagram: de Salesforce-API'er, en ekstern klient kan kalde (SOAP, REST, Bulk, Apex SOAP og REST, Metadata, Tooling, Streaming og Pub/Sub) efter at have autentificeret sig via en forbundet app og en integrationsbruger

Når Salesforce er serveren, kan der være brug for en forbundet app, en integrationsprofil og en integrationsbruger til OAuth-opsætningen. Klienterne kan være forskellige eksterne systemer, der kalder ind i Salesforce med forskellige API’er og protokoller efter behov.

Salesforce som klient

Diagram: Salesforce som klient, der kalder eksterne servere: connectorer til Marketing Cloud, Account Engagement og B2C Commerce, udgående Apex SOAP- og REST-callouts, External Services, udgående meddelelser, Salesforce Connect med OData og Heroku Connect

Salesforce kan også være klient og lave udgående kald til eksterne servere. Det kan indebære at importere WSDL-filer, generere Apex og sætte navngivne legitimationsoplysninger op til SOAP- og REST-servere. Forskellige udgående mekanismer kræver forskellige konfigurationer, og de følger alle de klient-server-protokoller, der er beskrevet ovenfor.

Konklusion

At forstå dansetrinene i samspillet mellem klient og server i API-kald til Salesforce er afgørende for at bruge API’er effektivt. Vi har gennemgået ansvaret på begge sider og set på scenarier med eksterne klienter og Salesforce i forskellige roller.

Hold øje

For flere indsigter og tips, hold øje her på www.SteveTechArc.com og på YouTube-kanalen @SteveTechArc (opens in a new tab). Abonnér, og styrk din forståelse af Salesforce, og hvordan du kan integrere det med andre systemer.

Vi hjælper med at forandre verden ved at dele integrationsviden med andre arkitekter og med dem, der er på vej til at blive arkitekter!

Dyk ned i den tekniske buffet, og bliv ved med at feste på teknologi. Forbliv nørdet!

Transskription med hjælp fra AI

STA 1.3