Prácticas recomendadas de integración de Marketo
Diseñe integraciones en torno a los límites de API compartidas para su instancia de Marketo. Utilice lotes, almacenamiento en caché y tasas de solicitud conservadoras para mejorar el rendimiento y la fiabilidad.
Límites de API
- Cuota diaria: A la mayoría de las suscripciones se les asignan 50 000 llamadas de API al día. La cuota se restablece diariamente a las 12:00 (CST). Póngase en contacto con su administrador de cuentas para aumentar la cuota diaria.
- Límite de velocidad: Cada instancia está limitada a 100 llamadas de API por 20 segundos.
- Límite de concurrencia: Cada instancia permite un máximo de diez llamadas API simultáneas.
- Tamaño del lote: La base de datos de posibles clientes admite 300 registros; la consulta de recursos admite 200 registros.
- Tamaño de carga útil de API de REST: 1 MB.
- Tamaño de archivo de importación masiva: 10 MB.
- Tamaño máximo de lote de SOAP: 300 registros.
- Trabajos de extracción masiva: Dos en ejecución y diez en cola, ambos incluidos.
Sugerencias rápidas
- Establezca límites de uso conservadores porque su aplicación comparte recursos de cuota, tasa y concurrencia con otras aplicaciones.
- Utilice los métodos por lotes y por lotes de Marketo cuando estén disponibles. Utilice llamadas de un solo registro o de un solo resultado solo cuando sea necesario.
- Use retroceso exponencial para reintentar las llamadas a la API que fallan debido a los límites de velocidad o concurrencia.
- Evite las llamadas de API simultáneas a menos que beneficien a su caso de uso.
Lotes
Para las inserciones y actualizaciones, agrupe los registros en el menor número posible de transacciones. Al recuperar registros de un almacén de datos, agréguelos antes del envío en lugar de enviar una solicitud para cada cambio.
Latencia aceptable
Defina la latencia aceptable (el tiempo máximo antes de enviar una llamada de API) al diseñar una integración. Esta opción determina qué métodos y opciones de configuración de Marketo se ajustan al caso de uso.
Por ejemplo, una integración en tiempo real que notifica a un vendedor cuando un usuario inicia una prueba puede enviar lotes de uno cuando se requiere un seguimiento inmediato. La mayoría de los casos de uso toleran una mayor latencia y funcionan de forma más eficiente poniendo en cola y agrupando llamadas.
Límites diarios
Cada instancia de Marketo habilitada para la API tiene una asignación diaria de al menos 10 000 llamadas a la API de REST, aunque son comunes 50 000 o más. Cada instancia también tiene 500 MB o más de capacidad de extracción masiva. Se puede adquirir capacidad diaria adicional como parte de una suscripción de Marketo, pero los diseños de aplicaciones deben tener en cuenta los límites comunes de suscripción.
Todos los servicios y usuarios de API comparten la capacidad en una instancia. Elimine llamadas redundantes y registros por lotes en el menor número posible de llamadas.
El método de importación más eficiente para las llamadas es la API de importación masiva de Marketo, disponible para posibles clientes/personas y objetos personalizados. Marketo también proporciona extracción en lotes para posibles clientes y actividades.
Almacenamiento en caché
Los resultados de las siguientes operaciones se pueden almacenar en caché en el lado del cliente durante un día o más, ya que cambian con poca frecuencia:
- Resultados de las operaciones de descripción
- Tipos de actividad
- Particiones
En casos de uso, como el enriquecimiento de datos de clientes potenciales o de actividad, también puede almacenar en caché tipos de recursos como programas, correos electrónicos y carpetas.
Límite de velocidad
Cada instancia de Marketo tiene un límite de tasa compartida de 100 llamadas por 20 segundos en todos los servicios de API de terceros. Si las llamadas superan este límite, la API devuelve un código de error 606.
En general, limite cada integración de terceros a 50 llamadas por 20 segundos o menos para que varias integraciones de API y usuarios puedan compartir la capacidad disponible. Algunos casos de uso pueden necesitar el límite completo. Sin embargo, las aplicaciones que utilizan el agrupamiento y se dirigen a un menor rendimiento suelen ser más adaptables y coherentes, con un pequeño aumento de la latencia.
Límite de concurrencia
Cada instancia de Marketo tiene un límite compartido de diez llamadas a la API de REST que se ejecutan simultáneamente. No dé por hecho que su aplicación es el único consumidor de este límite.
Marketo cuenta las llamadas que se están procesando y aún no han devuelto. Cuando se devuelve una llamada a, ya no se cuenta para el límite de concurrencia.
La mayoría de las integraciones no se benefician de las llamadas simultáneas. Si implementa la concurrencia, limite inicialmente la aplicación a cinco o menos solicitudes simultáneas. Aumente el límite solo después de determinar que la aplicación requiere más.
Errores
Excepto en casos excepcionales, las solicitudes de API devuelven el código de estado HTTP 200. Los errores de lógica empresarial también devuelven 200, pero incluyen detalles en el cuerpo de respuesta. Consulte Códigos de error para obtener más información.
No evalúe la frase de motivo HTTP porque es opcional y está sujeta a cambios.