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 grandes categorías: Base de datos de posibles clientes, y Recurso. Las API de base de datos de posibles clientes permiten recuperar e interactuar con registros de personas de Marketo y 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 sigue devolviendo un código de estado de 200, pero la respuesta JSON contiene un miembro de "éxito" con un valor de falsey una matriz de errores en el miembro "errors". Más información sobre errores aquí.

Introducción

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

Para la primera llamada a Marketo, recuperará 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 Funciones y, a continuación, Nuevo rol y asigne al menos el permiso "Solo lectura de posible cliente" (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, vuelva a la Usuarios y haga 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, y haga clic en Siguiente.

A continuación, compruebe la Solo API y asigne al usuario la función de API que ha creado y haga clic en Siguiente.

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

A continuación, vaya a Administrador y haga clic en LaunchPoint.

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

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

A continuación, vaya a  Administrador y, a continuación, a Servicios web.

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

Abra una nueva pestaña del explorador e introduzca lo siguiente, utilizando la información adecuada para llamar a Obtener posibles clientes por tipo de filtro:

<Your Endpoint URL>/rest/v1/leads.json?access_token=<Your Access Token>&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. Consulte su uso yendo a Administrador -> Integración > Servicios web y haciendo clic en el número de llamadas en los últimos siete días.