Límites de solicitudes

Límites de solicitudes por workspace en cada plan, ventanas separadas para decisiones y lecturas, los headers X-RateLimit en cada llamada, Retry-After en el 429 y cómo reducir el ritmo.

La API pública limita cuántas solicitudes puede hacer un workspace por minuto. El límite depende del plan del workspace:

PlanSolicitudes por minuto
Genesis60
Developer300
Growth2,000
Enterprise10,000

La página API Keys de la app muestra tu límite actual, y GET /v1/me lo devuelve como plan.rate_limit_per_minute.

Cómo se cuenta el límite

  • Por workspace, no por clave. Todas las claves de API de un workspace comparten un mismo presupuesto; crear más claves no agrega capacidad.
  • Las decisiones y las lecturas tienen ventanas separadas. POST /v1/decisions/{slug} cuenta en una ventana; los endpoints de lectura, GET /v1/decisions, GET /v1/me y GET /v1/executions, en otra con el mismo límite por minuto, así que consultarlos nunca frena tus decisiones. Las llamadas a la URL de webhook de una decisión tienen una tercera ventana propia (mismo límite, compartida por los webhooks del workspace), así que una URL filtrada no puede frenar tus claves de API. Cada solicitud al servidor MCP (initialize, tools/list, cualquier llamada a una herramienta) cuenta con las lecturas, y run_decision también cuenta con las decisiones. Las llamadas al webhook con una firma o un secreto incorrectos no afectan estas ventanas: tienen su propio presupuesto de 30 por minuto por webhook (luego 429).
  • Los subespacios comparten las ventanas de su workspace principal. En el modo partner, las llamadas con el header Dcision-Workspace cuentan en las ventanas de tu workspace, sea cual sea el cliente.
  • Ventanas fijas de un minuto. Una ventana se abre con la primera solicitud y dura 60 segundos; la siguiente solicitud después de eso abre una nueva.
  • Cada solicitud autenticada cuenta: las llamadas exitosas, los errores y las repeticiones idempotentes por igual. Las solicitudes con una clave no válida se rechazan antes del límite y no cuentan.

Headers

Cada respuesta autenticada lleva el estado de su ventana, la de decisiones o la de lecturas:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1791195060
HeaderDescripción
X-RateLimit-LimitSolicitudes permitidas por ventana para tu workspace.
X-RateLimit-RemainingSolicitudes restantes en la ventana actual.
X-RateLimit-ResetCuándo termina la ventana actual, en segundos Unix.

Cuando alcanzas el límite

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1791195060
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Slow down and retry after the reset time.",
    "request_id": "req_Tz6Kq1mW8vLp3Xc9Rn4D"
  }
}

Espera Retry-After segundos y vuelve a intentarlo. Las solicitudes enviadas antes de eso siguen fallando, y siguen contando.

async function decide(slug, state) {
  for (let attempt = 0; attempt < 3; attempt++) {
    const response = await fetch(`https://api.dcision.io/v1/decisions/${slug}`, {
      method: "POST",
      headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}`, "Content-Type": "application/json" },
      body: JSON.stringify({ state }),
    });
    if (response.status !== 429) return response;
    const wait = Number(response.headers.get("Retry-After") ?? "1");
    await new Promise((resolve) => setTimeout(resolve, wait * 1000));
  }
  throw new Error("Still rate limited after 3 attempts");
}

Mantenerse por debajo del límite

  • Vigila X-RateLimit-Remaining y reduce el ritmo antes de que llegue a 0.
  • Suaviza los picos con una cola o un token bucket de tu lado en lugar de enviarlos todos a la vez.
  • No repartas la carga en más claves: comparten el presupuesto del workspace.
  • ¿Necesitas más? Mejora tu plan, o habla con sales@dcision.io sobre Enterprise.

Límites del Playground

Las ejecuciones del Playground tienen su propio tope, separado de la API: 30 ejecuciones por minuto y 2,000 ejecuciones por día por workspace. Por encima, el Playground responde 429 RATE_LIMITED; usa una clave de API para volumen.

Capacidad del motor

El proveedor del motor tiene sus propios límites, en solicitudes y tokens por segundo. Con la clave del motor de Dcision, se comparten entre todos los workspaces, así que Dcision suaviza los picos: una decisión espera un espacio libre dentro de su timeoutMs en lugar de fallar de inmediato. Si no se libera ninguno a tiempo, la llamada falla con 503 ENGINE_RATE_LIMITED: un error del motor, reintentable con backoff, no el 429 RATE_LIMITED de tu workspace. Con tu propia clave de proveedor, se aplican los límites de tu cuenta del proveedor. Consulta Motores y BYOK.

En esta página