API de REST

La API de REST de Marketo proporciona acceso remoto a muchas funciones del sistema. Puede utilizarlo para crear programas, importar posibles clientes de forma masiva y controlar una instancia de Marketo a nivel detallado.

Las API de REST se dividen en dos grandes categorías:

Las llamadas a la API estándar tienen una longitud URI máxima de 8 KB y un tamaño corporal máximo de 1 MB. Las llamadas API masivas admiten un tamaño máximo de cuerpo de 10 MB.

Cuando una llamada a contiene un error, la API suele devolver el código de estado HTTP 200. La respuesta JSON contiene un miembro success con un valor de false y una matriz de errores en el miembro errors. Encontrará más información sobre errores aquí.

Introducción

Necesita privilegios de administrador en la instancia de Marketo para completar los siguientes pasos. Este flujo de trabajo crea credenciales de API y las utiliza para recuperar un registro de posibles clientes.

En primer lugar, cree un usuario de API y obtenga credenciales para las llamadas autenticadas. Inicie sesión en su instancia de y vaya a Administración > Usuarios y roles.

Seleccione la ficha Roles y, a continuación, seleccione Nuevo rol. Asigne la función al menos el permiso “Leer-Solo posible cliente” (o “Leer-Solo persona”) del grupo de API de acceso. Asigne un nombre descriptivo al rol y seleccione Crear.

Vuelva a la ficha Usuarios y seleccione Invitar nuevo usuario. Escriba un nombre descriptivo que identifique al usuario como usuario de API, escriba una dirección de correo electrónico y seleccione Siguiente.

Seleccione la opción Solo API, asigne el rol de API que creó y seleccione Siguiente.

Seleccione Enviar para crear el usuario.

A continuación, vaya al menú Administrador y seleccione LaunchPoint.

Seleccione Nuevo > Nuevo servicio. Escriba un nombre descriptivo y una descripción, y seleccione Personalizado del menú Servicio. Seleccione su nuevo usuario del menú Usuario solo de API y, a continuación, seleccione Crear.

Seleccione Ver detalles para que el nuevo servicio acceda al ID de cliente y al Secreto de cliente. Seleccione Obtener token para generar un token de acceso válido por una hora. Guarde el token para la primera llamada de API.

Vaya a Administración > Servicios web.

Busque el extremo en el cuadro API de REST y guárdelo para la primera llamada de API.

Cada llamada a la API de REST debe incluir un token de acceso en un encabezado HTTP.

Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int

Abra una nueva pestaña del explorador e introduzca la siguiente URL. Reemplace los marcadores de posición por el punto de conexión y la dirección de correo electrónico de la instancia para llamar a Obtener posibles clientes por tipo de filtro.

<Your Endpoint URL>/rest/v1/leads.json?&filterType=email&filterValues=<Your Email Address>

Si la base de datos no contiene un registro de posibles clientes con su dirección de correo electrónico, utilice la dirección de correo electrónico de un posible cliente existente. Envíe la dirección URL para recibir una respuesta JSON similar al siguiente ejemplo:

{
    "requestId":"c493#1511ca2b184",
    "result":[
       {
           "id":1,
           "updatedAt":"2015-08-24T20:17:23Z",
           "lastName":"Elkington",
           "email":"developerfeedback@marketo.com",
           "createdAt":"2013-02-19T23:17:04Z",
           "firstName":"Kenneth"
        }
    ],
    "success":true
}

Uso de API

El informe de uso de API rastrea cada usuario de API por separado. Asignar un usuario independiente a cada servicio web le ayuda a identificar el uso de API de cada integración.

Si las llamadas superan el límite de instancias y las llamadas subsiguientes fallan, utilice el informe para identificar el volumen de llamadas de cada servicio. Vaya a Administración > Integración > Servicios web y seleccione el número de llamadas realizadas en los últimos siete días.

Para ver los extremos REST que devuelven estadísticas de uso y error diarias y de los últimos 7 días, consulte Uso.