Migrerar till REST API
Marketo Engage SOAP API kommer att upphöra efter den 31 januari 2026. Alla befintliga integreringar som använder SOAP API bör dras tillbaka eller migreras till Marketo Engage REST API senast detta datum för att undvika avbrott i tjänsten.
Migrering
SOAP API har stöd för ett begränsat antal användningsfall jämfört med REST API. När du avgör vilka slutpunkter du ska mappa dina användningsfall bör du följa Marketo Integration Best Practices
Referensarkitekturer är tillgängliga för CRM-synkronisering och Data Warehouse Export.
Autentisering
Marketo REST API använder OAuth 2.0-baserad autentisering med typen Klientautentiseringsuppgifter. Åtkomsttoken är giltiga i en timme efter att de har skapats.
Leads
SOAP-API:t stöder synkronisering av huvuddata, Munchkin cookie-associering och sammanslagning av leads. Om ditt program anropar SOAP syncLead-metoden och ställer in parametern marketoCookie kan du migrera med något av följande:
- Använda REST-metoden Synkronisera leads, följt av Associerad lead
- Du kan anropa Skicka formulär, men detta kräver att du konfigurerar viss Marketing Assets och viss interaktion med Forms API
Program som använder nyckeltypen foreignSysPersonId bör migreras till att använda ett anpassat lead-fält för att representera den här externa identifieraren, och antingen använda Synkronisera leads eller bulklead-import REST-metoder.
M-objekt
M Objects var ett koncept för att stödja export av data för attribut av säljprojekt för extern analys och arbetade med tre objekttyper: säljprojekt, säljprojektsroller och program.
REST-dokumentation:
Statiska listor
Fall av statisk listanvändning i SOAP API är begränsade till inmatning av medlemskap och lead-data och borttagning av medlemskap som kan utföras med Lägg till i lista, Massimportleads eller Ta bort från lista REST-metoder.
Aktiviteter
SOAP API har bara stöd för hämtning av aktiviteter.
REST-dokumentation:
Kampanjer
REST-dokumentation:
SOAP API har bara stöd för tre användningsfall för smarta kampanjer: Utlösa leads för att kvalificera sig för en begärbar smart kampanj, hämta de begärbara kampanjerna och Schemalägga en framtida körning av en smart kampanj.
Anpassade objekt
REST-dokumentation:
SOAP API stöder bara CRUD-åtgärder för anpassade objekt.