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

Blog · 10 oktober 2023 · Steve Simpson · Integratie

Across the APIs: overzicht van de Salesforce-API's

Welkom bij weer een aflevering van de integratiereeks. Deze keer verkennen we de ingewikkelde wereld van de Salesforce-API’s, een cruciaal onderdeel voor effectieve integraties.

Inleiding tot de Salesforce-API’s

Je weg vinden in de Salesforce-API’s

Salesforce biedt een overvloed aan API’s, elk met een eigen doel en eigen functionaliteit. Deze gids neemt je mee door die API’s en helpt je begrijpen hoe je ze effectief gebruikt voor verschillende integratietaken.

Authenticatie begrijpen

Voordat we in de API’s duiken, is het cruciaal om het authenticatieproces te begrijpen. Als een browser Salesforce benadert, authenticeert hij zich bij een server voordat hij de privécontent bereikt. Die authenticatie is essentieel, of je nu openbare websites benadert, Experience-portalen, of zelfs openbare pagina’s voor web-to-lead en web-to-case.

Diagram: toegang tot Salesforce en API's. Een clientapplicatie en een browser authenticeren via de authenticatieserver en bereiken dan geversioneerde webservices (de standaard-API's), niet-geversioneerde aangepaste REST- en SOAP-services, openbare sites, Web-to-Lead en Email-to-Case

Geversioneerde en niet-geversioneerde webservers

Het belang van versiebeheer

Salesforce brengt API’s uit onder specifieke versienummers, en houdt hun mogelijkheden en compatibiliteit jarenlang in stand tot ze uiteindelijk uitgefaseerd worden.

Als afnemer moet je weten welke versie je gebruikt, en klaar zijn om naar nieuwere versies te upgraden (met testen).

Aangepaste REST- en SOAP-API’s

Voor aangepaste REST- of SOAP-API’s die je zelf maakt, biedt Salesforce geen versiebeheer. Het is jouw verantwoordelijkheid om die API’s te beheren en te onderhouden, en ervoor te zorgen dat ze bij elke Salesforce-update werken zoals verwacht.

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

Authenticatie van externe clients

Als externe clients Salesforce benaderen, moeten ze zich via specifieke flows authenticeren. Die clients kunnen van verschillende soorten zijn, waaronder SOAP-clients met de Enterprise- of Partner-WSDL, REST-clients, Bulk API-clients en vele andere.

Verschillende API’s verkennen

Salesforce heeft een breed scala aan API’s, elk ontworpen voor specifieke taken en functies. Van de nieuwe Salesforce Event Bus tot API’s voor verschillende sectoren zoals de zorg en de maakindustrie: er is voor bijna elke behoefte een API.

Schermafbeelding: de pagina Browse APIs op de site Salesforce Developers, met een lijst van API-kaarten

https://developer.salesforce.com/docs/apis (opens in a new tab)

Tools en hulpbronnen

Postman: de beste vriend van een developer

Voor developers die met de Salesforce-API’s werken, zijn tools als Postman onmisbaar. Met Postman kun je authenticaties en query’s uitvoeren, en zelfs data van buiten Salesforce invoegen, bewerken, bijwerken of verwijderen, wat het een essentieel hulpmiddel maakt voor het testen en ontwikkelen van API’s.

Schermafbeelding: een Postman-request dat een SOQL-query uitvoert op de Salesforce REST API, met de authorization-header en het JSON-antwoord

Documentatie en collecties gebruiken

Vertrouwd raken met de beschikbare documentatie is de sleutel tot het beheersen van de Salesforce-API’s. Hulpbronnen als de REST API Developer Guide en verschillende Postman-collecties op GitHub kunnen je ontwikkelproces flink vergemakkelijken.

Conclusie:

De Salesforce-API’s begrijpen en effectief gebruiken is cruciaal voor elke integratiedeveloper of -architect die met Salesforce werkt. Met een breed scala aan API’s en tools tot je beschikking kun je zowel data als configuratie in Salesforce efficiënt bewerken, lezen, wijzigen en bijwerken.

Verken, experimenteer en integreer naar hartenlust!

Blijf op de hoogte

Begin met vertrouwen aan je reis door de Salesforce-API’s! 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!

Transcript met hulp van AI

STA 1.9