Usted está aquí:
Límites y pautas de API
Utilice las API de Marketing Cloud Engagement para integrar sus aplicaciones y otros sistemas tecnológicos con Marketing Cloud Engagement. Para proteger nuestro Servicio y garantizar la disponibilidad de Marketing Cloud Engagement para todos los clientes, Salesforce establece límites en el uso de API.
Tipos de límites
Hay dos tipos de límites de API. Un límite máximo es aquel que no se puede superar. En la mayoría de los casos, si emite una solicitud de API que excede un límite máximo, la API rechaza la solicitud y devuelve un error.
Un límite flexible es aquel que puede deteriorar el desempeño si lo supera. Salesforce se reserva el derecho de limitar el índice de solicitudes de API si causan problemas de rendimiento o seguridad del sistema. En algunos casos, deberá comprar licencias o asignaciones adicionales si supera un límite flexible.
Límites generales de API
Los límites de esta sección se aplican a las API de REST y SOAP de Marketing Cloud Engagement.
| Recursos | Límite | Tipo de límites | Detalles |
|---|---|---|---|
| Volumen máximo de solicitudes de API | El límite depende de su edición
|
Límite flexible | Puede comprar una asignación adicional de contactos o solicitudes de API. Haga contacto con su ejecutivo de cuentas para obtener más información. |
| Número máximo de solicitudes asincrónicas por día | 50 millones de solicitudes por día | Límite flexible | Este límite se aplica a las solicitudes asincrónicas de las API de REST y API de SOAP. |
| Número máximo de solicitudes de token de acceso | 1 solicitud cada 20 minutos por máquina cliente | Límite flexible | No solicite un token nuevo con cada solicitud de API. En su lugar, utilice el parámetro expires_in en la respuesta a una solicitud de token para determinar cuánto tiempo permanece válido un token de acceso existente. Solicite un nuevo token solo cuando caduque el token existente. |
| Tamaño máximo de lote para solicitudes de API simultáneas | 50 objetos | Límite flexible | — |
| Tamaño máximo de lote para solicitudes de API asincrónicas | 32.000 objetos | Límite máximo | — |
| Período mínimo de tiempo de espera de solicitud para solicitudes de API simultáneas | El periodo de tiempo de espera depende del tipo de operación de API
|
Límite flexible | Haga coincidir los valores de tiempo de espera de sus clientes de API con estos valores. |
| Período mínimo de tiempo de espera de solicitud para solicitudes de API asincrónicas | 30 segundos | Límite flexible | Haga coincidir los valores de tiempo de espera de sus clientes de API con estos valores. |
Límites de API de REST de Marketing Cloud Engagement
La API de REST de Marketing Cloud Engagement le proporciona un acceso amplio a las funciones y capacidades de varias aplicaciones, incluyendo Content Builder y Journey Builder.
| Recursos | Límite | Tipo de límites | Detalles |
|---|---|---|---|
| Tasa de solicitud máxima para solicitudes de API de mensajería transaccional | 1000 solicitudes por segundo para mensajes estáticos y simples | Límite flexible | Un mensaje estático no contiene bloques de contenido ni elementos de personalización. Un mensaje simple incluye un bloque de contenido HTML y 1 o 2 elementos de personalización, como el nombre del destinatario y el número de pedido. Los mensajes transaccionales que incluyen más de un bloque de contenido y elementos de personalización distintos del nombre y el número de pedido tienen índices de desempeño más bajas. |
| Tasa de solicitud máxima para solicitudes de API de mensajería transaccional basadas en lotes | 250 solicitudes por segundo | Límite flexible | Este límite supone un tamaño de lote de 50 destinatarios por solicitud y un cuerpo de mensaje estático o simple. |
| Tasa de solicitud máxima para solicitudes de API de dispositivo simultáneas | 4.000 solicitudes por minuto | Límite flexible | — |
| Tasa de solicitud máxima para solicitudes de API simultáneas | 2.500 solicitudes por minuto | Límite flexible | Este límite se aplica a todas las solicitudes de API, excepto las solicitudes de API de dispositivo y las solicitudes de token de acceso. |
| Número máximo de conexiones simultáneas | 100 conexiones | Límite flexible | — |
| Tamaño máximo de carga de solicitud para API de autenticación | 8 KB | Límite máximo | — |
| Tamaño máximo de carga de solicitud para API de datos | 5.9 MB | Límite máximo | — |
| Tamaño máximo de carga de solicitud para API de activos | 25 MB | Límite máximo | — |
| Tamaño máximo de carga de solicitud para la API de mensajería | 16 MB | Límite máximo | — |
| Tamaño máximo de carga de solicitud para la API de automatización | 27.9 MB | Límite máximo | — |
| Tamaño máximo de carga de solicitud para todas las demás API de Marketing Cloud Engagement | 4 MB | Límite máximo | — |
| Tamaño máximo de lote para la API de envío de MobilePush | 5.000 objetos | Límite máximo | — |
| Tamaño de lote para la API de llamada de ENS | Mínima: 100 objetos Máximo: 1.000 objetos |
Límite máximo | — |
Límites de API de SOAP de Marketing Cloud Engagement
La API de SOAP de Marketing Cloud Engagement proporciona una integración en profundidad con Email Studio. Puede utilizar la API de SOAP para crear y enviar mensajes de correo electrónico y para ver los datos de respuesta de los mensajes de correo electrónico.
| Recursos | Límite | Tipo de límites | Detalles |
|---|---|---|---|
| Tasa de solicitud máxima para solicitudes de API simultáneas | 2500 solicitudes de API por minuto | Límite flexible | — |
| Número máximo de conexiones simultáneas | 100 conexiones | Límite flexible | — |
| Tamaño máximo de carga de solicitud | 28.6 MB | Límite máximo | — |
| Número máximo de registros devueltos por respuesta | 2.500 registros por respuesta | Límite máximo | Si un resultado contiene más de 2500 registros, la API proporciona un token que puede utilizar en una solicitud posterior para recuperar el siguiente lote de 2500 registros. |
