Cuántas conexiones y consultas puedes tener

Este artículo contesta una sola pregunta: «¿por qué me rebota?». Son los topes que rigen tus conexiones, todos juntos.

Antes de empezar#

• Los topes son del producto, no de tu plan: no se compran ni se amplían.
• Lo que sí depende del plan es tener conexiones: la API y los webhooks son del plan Empresarial.

Pasos#

1. Hasta 10 conexiones activas por empresa. Al intentar la número once, la pantalla dice: «El cupo es de 10 APIs activas. Revoca una para crear otra.» Una conexión revocada deja de contar en el acto.
2. Hasta 3 destinos de aviso por conexión. El propio panel lo dice bajo su título: «hasta 3 por API». Al pasarte: «El cupo es de 3 webhooks por API.» Dar de baja uno libera su lugar.
3. Hasta 100 registros por consulta. La ficha de la API lo dice en «Cómo consultar»: «Solo GET. Paginado con cursor; máximo 100 por página.» Si no se pide nada, vienen 50. Para traer más, se pagina con el cursor.
4. 600 consultas por minuto por llave. Está publicado en el portal de desarrolladores, en «Límites del producto» › «Límites de peticiones» › «API pública /v1, por token». Al pasarte, la respuesta dice cuántos segundos esperar: «Reintenta en 30 segundos (Retry-After).»
5. Los avisos: 6 intentos y 10 fallos. Una entrega que no llega se reintenta con esperas cada vez más largas —de un minuto a ocho horas— hasta seis intentos; después queda «Muerta». Diez entregas muertas seguidas apagan el canal y te llega un correo.
6. El rastro de las entregas: 50 a la vista y 30 días de memoria. El panel «Entregas» enseña las últimas 50 de esa conexión; el rastro completo se conserva 30 días. Lo que se mandó no se guarda: «solo metadatos: el contenido muere al entregarse».
7. El buzón de pruebas: 24 horas, 500 entregas y 64 KB. La URL caduca al día siguiente de crearla, el buzón conserva las últimas 500 y una entrega más grande no se guarda: «El buzón de pruebas acepta entregas de hasta 64 KB. Esta no se guardó.»

Resultado#

Cuando algo rebote, sabes si es cupo, si es tamaño de página o si es ritmo, y qué hacer con cada uno.

Preguntas frecuentes#

¿Para qué existen estos topes? Para que la salida de datos de un taller no estorbe la operación de los demás. Son los mismos para todos.

¿Se pueden subir? No se venden ni se amplían por cuenta. Están publicados a propósito, para que quien te integra los pueda leer antes de escribir una línea: la página «Límites del producto» no pide sesión y se le puede pasar tal cual.

Mi sistema pide los datos cada minuto y me rebota. Casi siempre no es el ritmo, es que está bajando todo cada vez. Usa updated_since: trae solo lo que cambió desde la fecha que le pases, y con eso una sincronización normal cabe de sobra.

¿Dónde veo el cupo de conexiones que llevo? En «Integraciones», junto al título: dice cuántas APIs y cuántos webhooks activos tienes.

¿Cuántos eventos distintos puedo oír? No hay tope de eventos: el tope es de destinos. Un mismo webhook puede oír todos los que tu conexión exponga.