API de REST

Marketo expone una API de REST que permite la ejecución remota de muchas de las funcionalidades del sistema. Desde la creación de programas hasta la importación masiva de posibles clientes, hay muchas opciones que permiten un control preciso de una instancia de Marketo.

Estas API generalmente se dividen en dos categorías amplias: Base de datos de posibles clientes y Recurso. Las API de base de datos de posibles clientes permiten recuperar e interactuar con los registros de personas de Marketo y los tipos de objetos asociados, como Oportunidades y Compañías. Las API de activos permiten la interacción con material promocional y registros relacionados con el flujo de trabajo.

El tamaño de las llamadas estándar está limitado a una longitud URI de 8 KB y un tamaño de cuerpo de 1 MB, aunque el cuerpo puede ser de 10 MB para nuestras API masivas. Si hay un error en con la llamada, la API generalmente devolverá un código de estado de 200, pero la respuesta JSON contendrá un miembro "success" con un valor de false, y una matriz de errores en el miembro "errors". Más información sobre los errores aquí.

Introducción

Los siguientes pasos requieren privilegios de administrador en la instancia de Marketo.

Para la primera llamada a Marketo, recupera un registro de posibles clientes. Para empezar a trabajar con Marketo, debe obtener credenciales de API para realizar llamadas autenticadas a su instancia. Inicie sesión en su instancia de y vaya a Administrador -> Usuarios y funciones.

Haga clic en la ficha Roles y, a continuación, en Nuevo rol y asigne al menos el permiso "Posible cliente de solo lectura" (o "Persona de solo lectura") al rol en el grupo de API de acceso. Asegúrese de darle un nombre descriptivo y haga clic en Crear.

Ahora, vuelve a la ficha Usuarios y haz clic en Invitar nuevo usuario. Asigne un nombre descriptivo al usuario que indique que es un usuario de API y una dirección de correo electrónico. Luego, haga clic en Siguiente.

A continuación, marque la opción Solo API, asigne al usuario la función de API que creó y haga clic en Siguiente.

Para completar el proceso de creación de usuarios, haga clic en Enviar.

A continuación, vaya al menú Administrador y haga clic en LaunchPoint.

Haga clic en el menú Nuevo y seleccione Nuevo servicio. Asigne un nombre descriptivo al servicio y seleccione Personalizado en el menú desplegable Servicio. Asígnele una descripción y, a continuación, seleccione el nuevo usuario en el menú desplegable Usuario solo de API y haga clic en Crear.

Haga clic en Ver detalles para que el nuevo servicio acceda al ID de cliente y al Secreto de cliente. Por ahora, puede hacer clic en el botón Obtener token para generar un token de acceso válido por una hora. Guarde el token en una nota por ahora.

A continuación, ve al menú Administrador y luego a Servicios Web.

Busque el extremo en el cuadro de la API de REST y guárdelo en una nota por ahora.

Al realizar llamadas a métodos de API de REST, se debe incluir un token de acceso en cada llamada para que la llamada se realice correctamente. El token de acceso debe enviarse como un encabezado HTTP.

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

Abra una nueva ficha del explorador e introduzca lo siguiente, con la información apropiada para llamar a Obtener posibles clientes por tipo de filtro

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

Si no tiene un registro de posibles clientes con su dirección de correo electrónico en la base de datos, cámbiela por una que sepa que está allí. Pulse Intro en la barra URL y obtenga una respuesta JSON similar a la siguiente:

{
    "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

Cada uno de los usuarios de la API se recoge de forma individual en el informe de uso de la API, por lo que la división de los servicios web por usuario permite contabilizar fácilmente el uso de cada una de las integraciones. Si el número de llamadas de API a su instancia supera el límite y provoca que las llamadas posteriores fallen, el uso de esta práctica le permite contabilizar el volumen de cada uno de sus servicios y evaluar cómo resolver el problema. Para ver su uso, vaya a Administración -> Integración > Servicios web y haga clic en el número de llamadas en los últimos siete días.