Przetłumaczone przez AI. Jeszcze niesprawdzone przez społeczność. Czytaj po angielsku

Blog · 7 września 2023 · Steve Simpson · Integracja

Tango Salesforce: taniec API między klientem a serwerem

Wprowadzenie

Oto kilka spostrzeżeń o interakcjach między klientem a serwerem przy wywołaniach API w Salesforce. To kluczowy element naszej serii o integracji na stevetechart.com.

Tango Salesforce: taniec interakcji

W zawiłym tańcu wywołań API trzeba znać kroki. Diagram, który zaraz omówię, pokazuje kroki tego tańca, czyli interakcje między klientem a serwerem.

Diagram: czym w wywołaniu API zajmuje się klient, a czym serwer: lokalizacja, OAuth, protokół, kontrakt, ładunek, śledzenie i debugowanie oraz błędy

Obowiązki po stronie serwera

Niezależnie od tego, czy serwerem jest Salesforce, czy podmiot zewnętrzny, obowiązki są te same. Serwer musi być osiągalny, mieć proces nasłuchujący na określonym porcie (zwykle 443 dla SSL) i ewentualnie serwer uwierzytelniania, jeśli używany jest OAuth. Serwer określa protokół, dostarcza klientowi potrzebne pliki, decyduje o ładunku (payload) i może śledzić przychodzący ładunek oraz wydajność przetwarzania wewnętrznego.

Obowiązki po stronie klienta

Klient musi znać punkt końcowy, obsługiwać tokeny sesji i być przygotowany na błędy wygaśnięcia sesji. Musi wywołać właściwy protokół, poprawnie serializować dane i obsługiwać zwracane wartości. Klient może śledzić wychodzące ładunki i przychodzące odpowiedzi oraz obsługiwać różne błędy, przy czym odpowiedzialność za wychwytywanie i usuwanie tych błędów spoczywa na serwerze.

Salesforce jako serwer

Diagram: API Salesforce, które może wywołać klient zewnętrzny (SOAP, REST, Bulk, Apex SOAP i REST, Metadata, Tooling, Streaming i Pub/Sub) po uwierzytelnieniu przez connected app i użytkownika integracyjnego

Gdy Salesforce działa jako serwer, konfiguracja OAuth może wymagać connected app, profilu integracyjnego i użytkownika integracyjnego. Klientami mogą być różne podmioty zewnętrzne wywołujące Salesforce, korzystające w razie potrzeby z różnych API i protokołów.

Salesforce jako klient

Diagram: Salesforce jako klient wywołujący serwery zewnętrzne: konektory do Marketing Cloud, Account Engagement i B2C Commerce, wychodzące wywołania Apex SOAP i REST, External Services, komunikaty wychodzące (outbound messages), Salesforce Connect z OData oraz Heroku Connect

Salesforce może też działać jako klient i wykonywać wywołania wychodzące do serwerów zewnętrznych. Może to wymagać zaimportowania plików WSDL, wygenerowania kodu Apex i skonfigurowania named credentials dla serwerów SOAP i REST. Różne mechanizmy wychodzące wymagają różnych konfiguracji, a każdy z nich działa według opisanych wcześniej zasad klient–serwer.

Podsumowanie

Zrozumienie kroków tańca klient–serwer przy wywołaniach API Salesforce jest kluczowe dla wydajnego i skutecznego korzystania z API. Omówiliśmy obowiązki obu stron i scenariusze z klientami zewnętrznymi oraz z Salesforce w różnych rolach.

Bądźmy w kontakcie

Więcej spostrzeżeń i wskazówek znajdziesz tutaj, na www.SteveTechArc.com, i na kanale YouTube @SteveTechArc (opens in a new tab). Zasubskrybuj i pogłębiaj swoje zrozumienie Salesforce i tego, jak integrować go z innymi systemami.

Pomagam zmieniać świat, dzieląc się wiedzą o integracji z innymi architektami i z tymi, którzy są na drodze do architektury!

Zanurz się w technologicznym bufecie i ucztuj dalej. Zostań nerdem!

Transkrypcję wspomagała AI

STA 1.3