Você está aqui:
Limites e diretrizes de API
Use as APIs do Marketing Cloud Engagement para integrar seus aplicativos e outros sistemas de tecnologia ao Marketing Cloud Engagement. Para proteger nosso Serviço e garantir a disponibilidade do Marketing Cloud Engagement para todos os clientes, o Salesforce impõe limites ao uso da API.
Tipos de limite
Há dois tipos de limites de API. Um limite fixo é um limite que você não pode exceder. Na maioria dos casos, se você emitir uma solicitação de API que excede um limite fixo, a API rejeitará a solicitação e retornará um erro.
Um limite variável é aquele que poderá reduzir o desempenho se você excedê-lo. A Salesforce reserva-se o direito de aplicar solicitações de API de limite de frequência se elas causarem problemas de desempenho ou segurança do sistema. Em alguns casos, você deverá adquirir licenças ou alocações adicionais se exceder um limite variável.
Limites de API gerais
Os limites nesta seção se aplicam a APIs REST e SOAP de engajamento do Marketing Cloud.
| Recurso | Limite | Tipo de limite | Detalhes |
|---|---|---|---|
| Volume máximo de solicitações de API | O limite depende da sua edição
|
Limite variável | Você pode adquirir uma alocação adicional de contatos ou solicitações de API. Entre em contato com seu executivo de conta para obter mais informações. |
| Número máximo de solicitações assíncronas por dia | 50 milhões de solicitações por dia | Limite variável | Esse limite se aplica a solicitações de API REST e API SOAP assíncronas. |
| Número máximo de solicitações de token de acesso | 1 solicitação a cada 20 minutos por máquina de cliente | Limite variável | Não solicite um novo token a cada solicitação de API. Em vez disso, use o parâmetro expires_in na resposta a uma solicitação de token para determinar por quanto tempo um token de acesso existente permanece válido. Solicite um novo token somente quando o token existente expirar. |
| Tamanho máximo do lote para solicitações de API síncronas | 50 objetos | Limite variável | — |
| Tamanho máximo do lote para solicitações de API assíncronas | 32.000 objetos | Limite fixo | — |
| Período de tempo limite mínimo da solicitação para solicitações de API síncronas | O período de tempo limite depende do tipo de operação da API
|
Limite variável | Corresponda os valores de tempo limite de seus clientes de API com estes valores. |
| Período de tempo limite mínimo da solicitação para solicitações de API assíncronas | 30 segundos | Limite variável | Corresponda os valores de tempo limite de seus clientes de API com estes valores. |
Limites da API REST de Engajamento do Marketing Cloud
A API REST de Engajamento do Marketing Cloud oferece acesso amplo aos recursos e funcionalidades de vários aplicativos, incluindo o Content Builder e o Journey Builder.
| Recurso | Limite | Tipo de limite | Detalhes |
|---|---|---|---|
| Taxa de solicitações máxima para solicitações de API de mensagens de transação | 1.000 solicitações por segundo para mensagens estáticas e simples | Limite variável | Uma mensagem estática não contém nenhum bloco de conteúdo ou elemento de personalização. Uma mensagem simples inclui um bloco de conteúdo HTML e 1 a 2 elementos de personalização, como o nome e o número do pedido do destinatário. Mensagens de transação que incluem mais de um bloco de conteúdo e elementos de personalização diferentes de nome e número do pedido têm menores taxas de rendimento. |
| Taxa de solicitações máxima para solicitações de API de mensagens de transação em lote | 250 solicitações por segundo | Limite variável | Esse limite presume um tamanho de lote de 50 destinatários por solicitação e um corpo de mensagem estático ou simples. |
| Taxa de solicitações máxima para solicitações de API de dispositivos síncronas | 4.000 solicitações por minuto | Limite variável | — |
| Taxa de solicitações máxima para solicitações de API síncronas | 2.500 solicitações por minuto | Limite variável | Esse limite se aplica a todas as solicitações de API, exceto solicitações de API de dispositivos e solicitações de tokens de acesso. |
| Número máximo de conexões simultâneas | 100 conexões | Limite variável | — |
| Tamanho máximo da carga útil da solicitação para a API de autenticação | 8 KB | Limite fixo | — |
| Tamanho máximo da carga útil da solicitação para a API de dados | 5,9 MB | Limite fixo | — |
| Tamanho máximo da carga útil da solicitação para a API de ativo | 25 MB | Limite fixo | — |
| Tamanho máximo da carga útil da solicitação para a API de mensagens | 16 MB | Limite fixo | — |
| Tamanho máximo da carga útil da solicitação para a API de automação | 27,9 MB | Limite fixo | — |
| Tamanho máximo da carga útil da solicitação para todas as outras APIs do Marketing Cloud Engagement | 4 MB | Limite fixo | — |
| Tamanho máximo do lote para a API de envio de MobilePush | 5.000 objetos | Limite fixo | — |
| Tamanho de lote para a API de retorno de chamada de ENS | Mínimo: 100 objetos Máximo: 1.000 objetos |
Limite fixo | — |
Limites da API SOAP de engajamento do Marketing Cloud
A API SOAP do Marketing Cloud Engagement fornece integração aprofundada com o Email Studio. Você pode usar a API SOAP para criar e enviar mensagens de email e para visualizar dados de resposta para mensagens de email.
| Recurso | Limite | Tipo de limite | Detalhes |
|---|---|---|---|
| Taxa de solicitações máxima para solicitações de API síncronas | 2.500 solicitações de API por minuto | Limite variável | — |
| Número máximo de conexões simultâneas | 100 conexões | Limite variável | — |
| Tamanho máximo de carga útil de solicitação | 28,6 MB | Limite fixo | — |
| Número máximo de registros retornados por resposta | 2.500 registros por resposta | Limite fixo | Se um resultado contiver mais de 2.500 registros, a API fornecerá um token que você pode usar em uma solicitação subsequente para recuperar o próximo lote de 2.500 registros. |
