Práticas recomendadas de integração do Marketo
Projete integrações em torno dos limites da API compartilhada para sua instância do Marketo. Use o agrupamento, o armazenamento em cache e taxas de solicitação conservadoras para melhorar a taxa de transferência e a confiabilidade.
Limites da API
- Cota diária: A maioria das assinaturas tem 50.000 chamadas de API alocadas por dia. A cota é redefinida diariamente às 12h (CST). Entre em contato com o gerente da conta para aumentar a cota diária.
- Limite de taxa: cada instância é limitada a 100 chamadas de API por 20 segundos.
- Limite de simultaneidade: cada instância permite no máximo dez chamadas de API simultâneas.
- Tamanho do lote: o BD de cliente potencial oferece suporte a 300 registros; a Consulta de Ativos oferece suporte a 200 registros.
- Tamanho da carga da API REST: 1 MB.
- Tamanho do arquivo de importação em massa: 10 MB.
- Tamanho máximo de lote do SOAP: 300 registros.
- Trabalhos de extração em massa: Dois em execução e dez em fila, inclusive.
Dicas rápidas
- Defina limites de uso conservadores porque seu aplicativo compartilha recursos de cota, taxa e simultaneidade com outros aplicativos.
- Use os métodos em massa e em lote do Marketo quando disponíveis. Use chamadas de registro único ou resultado único somente quando necessário.
- Use o retrocesso exponencial para repetir chamadas de API que falharam devido a limites de taxa ou simultaneidade.
- Evite chamadas de API simultâneas, a menos que elas beneficiem seu caso de uso.
Colocação em lote
Para inserções e atualizações, agrupe registros no menor número de transações possível. Ao recuperar registros de um armazenamento de dados, agregue-os antes do envio em vez de enviar uma solicitação para cada alteração.
Latência Aceitável
Defina a latência aceitável — o tempo máximo antes do envio de uma chamada de API — ao projetar uma integração. Essa opção determina quais métodos e opções de configuração do Marketo se encaixam no caso de uso.
Por exemplo, uma integração em tempo real que notifica um vendedor quando um usuário inicia uma avaliação pode enviar lotes de um quando é necessário acompanhamento imediato. A maioria dos casos de uso tolera mais latência e opera com mais eficiência enfileirando e agrupando chamadas.
Limites diários
Cada instância do Marketo habilitada para API tem uma alocação diária de pelo menos 10.000 chamadas de API REST, embora 50.000 ou mais sejam comuns. Cada instância também tem 500 MB ou mais de capacidade de Extração em massa. A capacidade diária adicional pode ser adquirida como parte de uma assinatura do Marketo, mas os designs de aplicativos devem levar em conta os limites de assinatura comuns.
A capacidade é compartilhada por todos os serviços e usuários da API em uma instância. Elimine chamadas redundantes e registros em lote no menor número possível de chamadas.
O método de importação com maior eficiência de chamada é a API de importação em massa do Marketo, disponível para Clientes potenciais/Pessoas e Objetos personalizados. A Marketo também fornece Extração em massa para Clientes potenciais e Atividades.
Armazenamento em cache
Os resultados das seguintes operações geralmente podem ser armazenados em cache no lado do cliente por um dia ou mais, pois são alterados com pouca frequência:
- Resultados das operações de Descrever
- Tipos de atividades
- Partições
Para casos de uso como lead ou enriquecimento de dados de atividade, você também pode armazenar em cache tipos de ativos como programas, emails e pastas.
Limite de taxa
Cada instância do Marketo tem um limite de taxa compartilhado de 100 chamadas por 20 segundos em todos os serviços de API de terceiros. Se as chamadas excederem esse limite, a API retornará um código de erro 606.
Em geral, limite cada integração de terceiros a 50 chamadas por 20 segundos ou menos para que várias integrações de API e usuários possam compartilhar a capacidade disponível. Alguns casos de uso podem precisar do limite completo. No entanto, os aplicativos que usam agrupamento e direcionam menor throughput geralmente são mais responsivos e consistentes, com um pequeno aumento na latência.
Limite de simultaneidade
Cada instância do Marketo tem um limite compartilhado de dez chamadas de API REST executadas simultaneamente. Não presuma que seu aplicativo é o único consumidor desse limite.
O Marketo conta as chamadas que estão sendo processadas e que ainda não foram retornadas. Quando uma chamada é retornada, ela não é mais contada para o limite de simultaneidade.
A maioria das integrações não se beneficia de chamadas simultâneas. Se você implementar a simultaneidade, limite inicialmente o aplicativo a cinco ou menos solicitações simultâneas. Aumente o limite somente depois de determinar que o aplicativo requer mais.
Erros
Exceto em casos raros, as solicitações de API retornam o código de status HTTP 200. Os erros de lógica de negócios também retornam 200, mas incluem detalhes no corpo da resposta. Consulte Códigos de erro para obter mais informações.
Não avalie a frase de motivo HTTP porque ela é opcional e está sujeita a alterações.