Migration vers l’API REST
L’API Marketo Engage SOAP sera supprimée après le 31 janvier 2026. Toutes les intégrations existantes utilisant l’API SOAP doivent être retirées ou migrées vers l’API REST Marketo Engage d’ici cette date afin d’éviter des interruptions de service.
Migration
L’API SOAP prend en charge un éventail limité de cas d’utilisation par rapport à l’API RESTI. Lorsque vous déterminez les points d’entrée à mapper à vos cas d’utilisation, vous devez suivre les bonnes pratiques d’intégration de Marketo
Les architectures de référence sont disponibles pour les cas d’utilisation de synchronisation CRM et exportation Data Warehouse.
Authentification
Documentation d’authentification
L’API REST Marketo utilise l’authentification basée sur OAuth 2.0 avec le type d’octroi des informations d’identification client . Les jetons d’accès sont valides pendant une heure après leur création.
Prospects
Documentation de l’API de lead
L’API SOAP prend en charge la synchronisation des données de prospect, l’association de cookies Munchkinet la fusion de prospects. Si votre application appelle la méthode syncLead de SOAP et définit le paramètre marketoCookie, vous pouvez effectuer la migration de l’une des manières suivantes :
- Utilisation de la méthode REST Sync Leads, suivie de Associated Lead
- Vous pouvez appeler Envoyer le formulaire, bien que cela nécessite la configuration de certaines Assets marketing et une interaction avec l’API Forms
Les applications qui utilisent le type de clé foreignSysPersonId doivent migrer vers à l’aide d’un champ de prospect personnalisé pour représenter cet identifiant externe et utiliser des méthodes REST Sync Leads ou Bulk Lead Import.
Mes objets
M Objects était un concept fourre-tout destiné à prendre en charge l’exportation des données d’attribution d’opportunités pour une analyse externe. Il fonctionnait avec trois types d’objets : Opportunités, Rôles d’opportunités et Programmes.
Documentation REST :
Listes statiques
Liste statique Les cas d’utilisation dans l’API SOAP se limitent à l’ingestion des données d’abonnement et de prospect, ainsi qu’à la suppression de l’abonnement qui peut être effectuée à l’aide des méthodes REST Ajouter à la liste, Importer des prospects en bloc ou Supprimer de la liste.
Activités
L’API SOAP ne prend en charge que la récupération des activités.
Documentation REST :
Campagnes
Documentation REST :
L’API SOAP ne prend en charge que trois cas d’utilisation de campagnes intelligentes : Déclenchement de la qualification des prospects pour une campagne intelligente pouvant faire l’objet d’une demande, récupération de ces campagnes intelligentes pouvant faire l’objet d’une demande et Planification d’une exécution future d’une campagne intelligente.
Objets personnalisés
Documentation REST :
L’API SOAP ne prenait en charge que les opérations CRUD pour les objets personnalisés.