Migración a la API de REST
La API de Marketo Engage SOAP se retirará después del 31 de octubre de 2025. Todas las integraciones existentes que usan la API de SOAP deben retirarse o migrarse a la API de REST de Marketo Engage en esta fecha para evitar interrupciones en el servicio.
Migración
La API de SOAP admite una gama limitada de casos de uso en comparación con REST API. A la hora de determinar qué extremos asignar a sus casos de uso, debe seguir Prácticas recomendadas de integración de Marketo
Las arquitecturas de referencia están disponibles para los casos de uso de Sincronización de CRM y Exportación de Data Warehouse.
Autenticación
Documentación de autenticación
La API de REST de Marketo utiliza la autenticación basada en OAuth 2.0 con el tipo de concesión de Credenciales del cliente. Los tokens de acceso son válidos durante una hora después de su creación.
Clientes potenciales
Documentación de API de cliente potencial
La API de SOAP admite la sincronización de datos de posibles clientes, la asociación de cookies de Munchkin y la combinación de posibles clientes. Si la aplicación llama al método syncLead de SOAP y establece el parámetro marketoCookie, puede migrar mediante:
- Usando el método REST Sincronizar posibles clientes, seguido de Posible cliente asociado
- Puede llamar a Enviar formulario, aunque para ello es necesario configurar algunas API de Marketing Assets e interactuar con Forms
Las aplicaciones que usan el tipo de clave foreignSysPersonId deberían migrar a mediante un campo de posible cliente personalizado para representar este identificador externo y usar Sincronizar posibles clientes o Importación masiva de posibles clientes métodos REST.
Objetos M
M Objects era un concepto global para admitir la exportación de datos de Atribución de oportunidad para análisis externos y trabajaba con tres tipos de objetos: Oportunidades, Funciones de oportunidad y Programas.
Documentación de REST:
Listas estáticas
Los casos de uso de listas estáticas en la API de SOAP se limitan a la ingesta de datos de pertenencia y posible cliente, y a la eliminación de la pertenencia, que se puede realizar con los métodos Agregar a lista, Importar posibles clientes en lote o Quitar de la lista REST.
Actividades
La API de SOAP solo admite la recuperación de actividades.
Documentación de REST:
Campañas
Documentación de REST:
La API de SOAP solo admite tres casos de uso para campañas inteligentes: Activar posibles clientes para que cumplan los requisitos para una campaña inteligente solicitada, recuperar esas campañas inteligentes solicitadas y Programar una ejecución futura de una campaña inteligente.
Objetos personalizados
Documentación de REST:
La API de SOAP solo admitía operaciones de CRUD para objetos personalizados.