Migrazione all’API REST
L’API SOAP di Marketo Engage verrà ritirata dopo il 31 ottobre 2025. Tutte le integrazioni esistenti che utilizzano l'API SOAP devono essere ritirate o migrate all'API REST Marketo Engage entro questa data per evitare interruzioni del servizio.
Migrazione
L'API SOAP supporta un intervallo limitato di casi d'uso rispetto all'API RESTI. Per determinare quali endpoint mappare i casi d'uso, segui Best practice di integrazione di Marketo
Architetture di riferimento disponibili per Sincronizzazione CRM e Esportazione Data Warehouse casi d'uso.
Autenticazione
Documentazione sull'autenticazione
L’API REST di Marketo utilizza l’autenticazione basata su OAuth 2.0 con il tipo di concessione Credenziali client. I token di accesso sono validi per un'ora dopo la creazione.
Lead
L'API SOAP supporta la sincronizzazione dei dati dei lead, l'associazione dei cookie Munchkin e l'unione dei lead. Se l'applicazione chiama il metodo syncLead di SOAP e imposta il parametro marketoCookie, è possibile eseguire la migrazione in uno dei modi seguenti:
- Utilizzo del metodo REST Lead di sincronizzazione, seguito da Lead associato
- È possibile chiamare Invia modulo, anche se questo richiede la configurazione di alcune Assets di marketing e l'interazione con l'API Forms
Le applicazioni che utilizzano il tipo di chiave foreignSysPersonId devono migrare a utilizzando un campo lead personalizzato per rappresentare questo identificatore esterno e utilizzare i metodi REST Lead di sincronizzazione o Importazione lead in blocco.
Oggetti M
M Objects era un concetto onnicomprensivo per supportare l'esportazione dei dati di Attribution dell'opportunità per l'analisi esterna e utilizzava tre tipi di oggetto: Opportunità, Ruoli opportunità e Programmi.
Documentazione REST:
Elenchi statici
I casi di utilizzo per elenchi statici nell'API di SOAP sono limitati all'acquisizione dei dati di appartenenza e lead e alla rimozione dell'appartenenza che può essere eseguita con i metodi REST Aggiungi all'elenco, Importa in blocco lead o Rimuovi dall'elenco.
Attività
L’API SOAP supporta solo il recupero delle attività.
Documentazione REST:
Campagne
Documentazione REST:
L'API SOAP supporta solo tre casi d'uso per le campagne intelligenti: Attivazione dei lead per qualificarsi per una campagna avanzata richiedente, recupero delle campagne richieste e Pianificazione dell'esecuzione futura di una campagna avanzata.
Oggetti personalizzati
Documentazione REST:
L’API SOAP supportava solo operazioni CRUD per gli oggetti personalizzati.