Tradotto con l'IA. Non ancora rivisto dalla comunità. Leggi in inglese

Blog · 10 ottobre 2023 · Steve Simpson · Integrazione

Across the APIs: panoramica delle API di Salesforce

Benvenuto in un’altra puntata della serie sull’integrazione. Questa volta esploriamo il complesso mondo delle API di Salesforce, un componente cruciale per integrazioni efficaci.

Introduzione alle API di Salesforce

Orientarsi tra le API di Salesforce

Salesforce offre una moltitudine di API, ognuna con scopi distinti e funzionalità diverse. Questa guida ti accompagna tra queste API e ti aiuta a capire come usarle in modo efficace per diverse attività di integrazione.

Capire l’autenticazione

Prima di addentrarsi nelle API, è fondamentale capire il processo di autenticazione. Quando un browser accede a Salesforce, si autentica presso un server prima di raggiungere i contenuti privati. Questa autenticazione è essenziale, sia che tu acceda a siti web pubblici, portali Experience o persino a pagine pubbliche per web-to-lead e web-to-case.

Diagramma: accesso a Salesforce e API. Un'applicazione client e un browser si autenticano tramite il server di autenticazione, poi raggiungono i servizi web con versione (le API standard), i servizi REST e SOAP personalizzati senza versione, i siti pubblici, Web-to-Lead ed Email-to-Case

Server web con e senza versione

L’importanza delle versioni

Salesforce rilascia le API con numeri di versione specifici e ne mantiene funzionalità e compatibilità per anni, finché non vengono ritirate.

Come consumatore, devi sapere quale versione stai usando ed essere pronto a passare alle versioni più recenti (dopo i test).

API REST e SOAP personalizzate

Per le API REST o SOAP personalizzate che crei tu, Salesforce non fornisce il versionamento. Gestirle e mantenerle è responsabilità tua, assicurandoti che funzionino come previsto a ogni aggiornamento di Salesforce.

Diagramma: le API di Salesforce che un client esterno può chiamare (SOAP, REST, Bulk, Apex SOAP e REST, Metadata, Tooling, Streaming e Pub/Sub) dopo essersi autenticato tramite un'app connessa e un utente di integrazione

Autenticazione dei client esterni

Quando i client esterni accedono a Salesforce, devono autenticarsi con flussi specifici. Questi client possono essere di vario tipo, tra cui client SOAP che usano il WSDL Enterprise o Partner, client REST, client Bulk API e molti altri.

Esplorare le diverse API

Salesforce vanta una vasta gamma di API, ognuna progettata per attività e funzioni specifiche. Dal nuovo Salesforce Event Bus alle API pensate per settori come sanità e manifattura, esiste un’API per quasi ogni esigenza.

Screenshot: la pagina Browse APIs del sito Salesforce Developers, con l'elenco delle schede delle API

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

Strumenti e risorse

Postman: il migliore amico di chi sviluppa

Per chi sviluppa con le API di Salesforce, strumenti come Postman sono preziosissimi. Postman ti permette di eseguire autenticazioni, query e persino di inserire, modificare, aggiornare o eliminare dati dall’esterno di Salesforce, ed è quindi uno strumento essenziale per testare e sviluppare le API.

Screenshot: una richiesta Postman che esegue una query SOQL sull'API REST di Salesforce, con l'intestazione di autorizzazione e la risposta JSON

Usare documentazione e collection

Familiarizzare con la documentazione disponibile è la chiave per padroneggiare le API di Salesforce. Risorse come la guida per sviluppatori dell’API REST e le varie collection Postman disponibili su GitHub possono semplificare molto il tuo lavoro.

Conclusione:

Capire e usare bene le API di Salesforce è fondamentale per chiunque sviluppi o progetti integrazioni con Salesforce. Con una vasta gamma di API e strumenti a disposizione, puoi manipolare, leggere, modificare e aggiornare in modo efficiente sia i dati sia le configurazioni di Salesforce.

Sentiti libero di esplorare, sperimentare e integrare!

Resta sintonizzato

Inizia con fiducia il tuo percorso tra le API di Salesforce! Per altri spunti e consigli, resta sintonizzato qui su www.SteveTechArc.com e sul canale YouTube @SteveTechArc (opens in a new tab). Iscriviti e approfondisci la tua comprensione di Salesforce e di come integrarlo con altri sistemi.

Contribuire a cambiare il mondo condividendo conoscenze sull’integrazione con altri architetti e con chi è in cammino per diventarlo!

Trascrizione realizzata con l’aiuto dell’IA

STA 1.9