Oversatt med KI. Fellesskapet har ikke gjennomgått oversettelsen ennå. Les på engelsk

Blogg · 7. september 2023 · Steve Simpson · Integrasjon

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

Introduksjon

Her er innsikt i samspillet mellom klient og server når du gjør API-kall i Salesforce, en avgjørende del av integrasjonsserien vår på stevetecharc.com.

Salesforce-tangoen: en dans av samspill

I API-kallenes intrikate dans er det viktig å forstå trinnene. Diagrammet jeg skal gå gjennom, viser dansetrinnene, altså samspillet mellom klienten og serveren.

Diagram: hva klienten og serveren hver for seg håndterer i et API-kall: plassering, OAuth, protokoll, kontrakt, payload, sporing og feilsøking, og feil

Serverens ansvar

Enten Salesforce eller et eksternt system er serveren, er ansvaret det samme. Serveren må være tilgjengelig, ha en lytteprosess på en bestemt port (som regel 443 for SSL) og eventuelt ha en autentiseringsserver hvis OAuth brukes. Serveren definerer protokollen, gir klienten filene som trengs, bestemmer payloaden og kan spore den innkommende payloaden og ytelsen i den interne behandlingen.

Klientens ansvar

Klienten må kjenne endepunktet, håndtere sesjonstokens og være forberedt på feil når sesjonen har utløpt. Den må kalle riktig protokoll, serialisere data riktig og håndtere returverdier. Klienten kan spore utgående payloads og innkommende svar og håndtere ulike feil, mens ansvaret for å fange og rette disse feilene ligger hos serveren.

Salesforce som server

Diagram: Salesforce-API-ene en ekstern klient kan kalle (SOAP, REST, Bulk, Apex SOAP og REST, Metadata, Tooling, Streaming og Pub/Sub) etter å ha autentisert seg via en tilkoblet app og en integrasjonsbruker

Når Salesforce er serveren, kan det kreves en tilkoblet app, en integrasjonsprofil og en integrasjonsbruker for OAuth-oppsettet. Klientene kan være ulike eksterne systemer som kaller inn i Salesforce, med ulike API-er og protokoller etter behov.

Salesforce som klient

Diagram: Salesforce som klient som kaller eksterne servere: koblinger til Marketing Cloud, Account Engagement og B2C Commerce, utgående Apex SOAP- og REST-callouts, External Services, utgående meldinger, Salesforce Connect med OData, og Heroku Connect

Salesforce kan også være klient og gjøre utgående kall til eksterne servere. Det kan innebære å importere WSDL-filer, generere Apex og sette opp navngitte legitimasjoner for SOAP- og REST-servere. Ulike utgående mekanismer krever ulike konfigurasjoner, og alle følger klient–server-protokollene som er beskrevet tidligere.

Konklusjon

Å forstå dansetrinnene i samspillet mellom klient og server i API-kall til Salesforce er avgjørende for å bruke API-er effektivt. Vi har gått gjennom ansvaret på begge sider og sett på scenarioer med eksterne klienter og Salesforce i ulike roller.

Følg med

For mer innsikt og flere tips, følg med her på www.SteveTechArc.com og på YouTube-kanalen @SteveTechArc (opens in a new tab). Abonner, og styrk forståelsen din av Salesforce og hvordan du kan integrere det med andre systemer.

Vi hjelper til med å forandre verden ved å dele integrasjonskunnskap med andre arkitekter og med dem som er på vei til å bli arkitekter!

Dykk ned i den tekniske buffeten og fortsett å forsyne deg av teknologi. Forbli nerdete!

Transkripsjon med hjelp fra AI

STA 1.3