Documentação Guia do desenvolvedor do Marketo

Migração para a API REST

Last update: Wed Jun 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
SOAP

Criado para:

Administrador

A API do Marketo Engage SOAP será desativada após 31 de outubro de 2025. Todas as integrações existentes que usam a API do SOAP devem ser removidas ou migradas para a API REST do Marketo Engage até esta data para evitar interrupções no serviço.

Migração

A API do SOAP oferece suporte a uma variedade limitada de casos de uso em comparação ao REST API. Ao determinar quais endpoints mapear seus casos de uso, você deve seguir as Práticas recomendadas de integração do Marketo

Arquiteturas de Referência estão disponíveis para casos de uso de Sincronização de CRM e Exportação de Data Warehouse.

Autenticação

Documentação de Autenticação

A API REST do Marketo usa autenticação baseada no OAuth 2.0 com o tipo de concessão Credenciais de cliente. Os tokens de acesso são válidos por uma hora após a criação.

Leads

Documentação da API de clientes potenciais

A API do SOAP oferece suporte à sincronização de dados de clientes potenciais, à associação de cookies do Munchkin e à mesclagem de clientes potenciais. Se o aplicativo chamar o método SOAP syncLead e definir o parâmetro marketoCookie, você poderá migrar:

Usando o método REST Sincronizar clientes em potencial, seguido por Cliente em potencial Associado
Você pode chamar Enviar Formulário, embora isso exija a configuração de alguma Assets de marketing e alguma interação com a API do Forms

Os aplicativos que usam o tipo de chave foreignSysPersonId devem migrar para o uso de um campo de cliente potencial personalizado para representar esse identificador externo e usar os Métodos REST Sincronizar Clientes Potenciais ou Importação de Cliente Potencial em Massa.

Método SOAP

Método(s) REST

getLead

Obter Cliente Potencial por ID, Obter Cliente Potencial por Tipo de Filtro

getMultipleLeads

Obter Cliente Potencial por ID, Obter Cliente Potencial por Tipo de Filtro, Obter Cliente Potencial por ID de Programa, Obter Cliente Potencial por ID de Lista, Exportação de Cliente Potencial em Massa

mergeLeads

Mesclar clientes em potencial

syncLead

Sincronizar Clientes Potenciais Enviar Formulário Associar Cliente Potencial

syncMultipleLeads

Clientes Potenciais de Sincronização Importação em Massa

Objetos M

M Objects era um conceito abrangente para oferecer suporte à exportação de dados de Atribuição de oportunidades para análise externa e trabalhou com três tipos de objetos: Oportunidades, Funções de oportunidades e Programas.

Documentação REST:

Método SOAP

Método(s) REST

excluirMObjects

Excluir Oportunidades, Excluir Funções De Oportunidade

descreverMObjects

Descrever oportunidade, Descrever função da oportunidade

getMObjects

Obter Oportunidades, Obter Funções de Oportunidade

listMObjects

N/D

syncMObjects

Sincronizar Oportunidades, Sincronizar Funções de Oportunidade

getChannels

Obter Canais

getTags

Obter Tipos de Marca, Obter Marca por Nome

Listas estáticas

Os casos de uso de lista estática na API do SOAP estão limitados à assimilação de dados de associação e de cliente potencial, bem como à remoção de associação, o que pode ser feito com os Métodos REST Adicionar à lista, Importar clientes potenciais em massa ou Remover da lista.

Método SOAP

Método(s) REST

getImportToListStatus

Clientes Potenciais de Importação em Massa

importToList

Adicionar À Lista Clientes Potenciais De Importação Em Massa

listOperation

Remover da lista