Límites
El servicio se protege a sí mismo y a cada tienda con topes fijos. Los números de abajo se leen de la configuración con la que funciona el servicio; al alcanzar un límite se responde 429 con Retry-After, 413 o 400 limit_exceeded.
Las rutas, los nombres de campo, los códigos de error, los nombres de cabecera y los ejemplos de código se quedan en inglés: son el contrato.
Los topes
La configuración de tu propia tienda fija los límites de trabajo de un pedido (limits.maxParts, los tamaños de pieza, las filas por pedido); esos los eliges tú y aparecen en GET /cfg/v1/config/public. Una tienda sandbox recibe los valores más bajos del sandbox.
Servicio
| Límite | Valor | Lo aplica |
|---|---|---|
| Solicitudes por dirección de cliente, todas las rutas juntas | 120 / min | cfg-limits.json service.ipPerMinute |
| Solicitudes por tienda, todas las rutas de la página de la tienda juntas | 1200 / min | cfg-limits.json service.tenantPerMinute |
| Cuerpo de la solicitud de una llamada de la página de la tienda | 1,000,000 B | CFG_MAX_BODY_BYTES |
| Cuerpo de la solicitud de la comprobación del presupuesto | 64,000 B | server.ts handleQuoteVerify |
| Vigencia del token del presupuesto | 7 d | CFG_QUOTE_TTL_S |
| Planes resueltos a la vez + en espera en la cola | 2 + 16 | CFG_MAX_CONCURRENT_SOLVES + CFG_MAX_SOLVE_QUEUE |
| Espera máxima de un plan del motor max | 90 s | CFG_MAX_ENGINE_WAIT_MS |
Tamaño del pedido
| Límite | Valor | Lo aplica |
|---|---|---|
| Filas de la lista de corte en un pedido | 2000 | ORDER_LIMITS.cutList |
| Líneas de tableros enteros en un pedido | 500 | ORDER_LIMITS.fullSheets |
| Líneas de herrajes en un pedido | 500 | ORDER_LIMITS.hardware |
| Líneas de presupuesto en un pedido | 5000 | ORDER_LIMITS.lines |
| Tamaño de un documento de pedido | 16,777,216 B | ORDER_LIMITS.documentBytes |
| Piezas, filas y tamaños de pieza: los fija la configuración de tu tienda | limits.* | tenant config |
Claves de prueba
| Límite | Valor | Lo aplica |
|---|---|---|
| Vigencia de la clave de prueba | 30 d | cfg-limits.json testKeys.ttlDays |
| Solicitudes por clave de prueba | 60 / min | cfg-limits.json testKeys.requestsPerMinute |
| Presupuestos por tienda con claves de prueba | 200 / d | cfg-limits.json testKeys.quotesPerDay |
| Pedidos por tienda con claves de prueba | 50 / d | cfg-limits.json testKeys.ordersPerDay |
Tienda sandbox
| Límite | Valor | Lo aplica |
|---|---|---|
| Duración del sandbox | 14 d | cfg-limits.json sandbox.lifetimeDays |
| Solicitudes por tienda sandbox | 60 / min | cfg-limits.json sandbox.requestsPerMinute |
| Vistas previas en vivo por tienda sandbox | 20 / min | cfg-limits.json sandbox.previewPerMinute |
| Piezas por trabajo en un sandbox | 100 | cfg-limits.json sandbox.maxParts |
| Pedidos por sandbox en la ventana móvil | 100 / 30 d | cfg-limits.json sandbox.ordersPerWindow |
| Endpoints de webhook de un sandbox | 2 | cfg-limits.json sandbox.webhooksMax |
Proyectos guardados y búsqueda
| Límite | Valor | Lo aplica |
|---|---|---|
| Cuerpo de un proyecto guardado | 65,536 B | cfg-limits.json projects.maxBodyBytes |
| Proyectos guardados por tienda | 2000 | cfg-limits.json projects.perTenant |
| Tamaño total de los proyectos guardados de una tienda | 50,000,000 B | cfg-limits.json projects.bytesPerTenant |
| Proyectos en una lista «mis proyectos» | 100 | projects.ts PROJECT_LIST_LIMIT |
| Tamaño de página de la búsqueda en el catálogo (predeterminado / máximo) | 24 / 100 | catalog/search.ts SEARCH_LIMITS |
Aquí no hay un botón «probar» a propósito: la clave secreta pertenece a tu servidor, nunca a un navegador. La tienda demo muestra la incrustación y el traspaso del pedido funcionando de principio a fin.
Información legalCondiciones del configurador (EN) ·Contrato de encargo de tratamiento (EN) ·Aviso de privacidad para compradores ·Licencias de terceros (EN)