Rate limits
Лимиты запросов на рабочее пространство для каждого тарифа, отдельные окна для решений и чтения, заголовки X-RateLimit в каждом вызове, Retry-After при 429 и как снижать нагрузку.
Публичный API ограничивает, сколько запросов рабочее пространство может сделать в минуту. Лимит зависит от тарифа рабочего пространства:
| Тариф | Запросов в минуту |
|---|---|
| Genesis | 60 |
| Developer | 300 |
| Growth | 2 000 |
| Enterprise | 10 000 |
Страница API-ключи в приложении показывает ваш текущий лимит, а GET /v1/me возвращает его как plan.rate_limit_per_minute.
Как считается лимит
- На рабочее пространство, а не на ключ. Все API-ключи рабочего пространства делят один бюджет; создание дополнительных ключей не добавляет пропускной способности.
- У решений и чтения отдельные окна.
POST /v1/decisions/{slug}считается в одном окне; endpoint'ы чтения —GET /v1/decisions,GET /v1/meиGET /v1/executions— в другом, с тем же лимитом в минуту, поэтому их опрос никогда не замедляет ваши решения. У вызовов URL вебхука решения есть собственное третье окно (тот же лимит, общий для вебхуков рабочего пространства), поэтому утёкший URL не может замедлить ваши API-ключи. Каждый запрос к MCP-серверу (initialize,tools/list, любой вызов инструмента) учитывается вместе с чтением, аrun_decision— ещё и вместе с решениями. Вызовы вебхука с неверной подписью или секретом эти окна не затрагивают: у них свой бюджет — 30 в минуту на вебхук (затем429). - Подпространства делят окна своего родителя. В режиме партнёра вызовы с заголовком
Dcision-Workspaceучитываются в окнах вашего рабочего пространства, какой бы ни был клиент. - Фиксированные окна в одну минуту. Окно открывается первым запросом и длится 60 секунд; следующий запрос после этого открывает новое.
- Учитывается каждый аутентифицированный запрос — и успешные вызовы, и ошибки, и идемпотентные повторы. Запросы с недействительным ключом отклоняются до проверки лимита и не учитываются.
Заголовки
Каждый аутентифицированный ответ сообщает состояние своего окна — окна решений или окна чтения:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1791195060| Заголовок | Описание |
|---|---|
X-RateLimit-Limit | Сколько запросов разрешено вашему рабочему пространству за окно. |
X-RateLimit-Remaining | Сколько запросов осталось в текущем окне. |
X-RateLimit-Reset | Когда заканчивается текущее окно, в секундах Unix. |
Когда вы достигли лимита
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"
}
}Подождите Retry-After секунд, затем повторите. Запросы, отправленные раньше, продолжают завершаться ошибкой — и продолжают учитываться.
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");
}Как оставаться в пределах лимита
- Следите за
X-RateLimit-Remainingи замедляйтесь, прежде чем он дойдёт до 0. - Сглаживайте всплески с помощью очереди или token bucket на своей стороне, а не отправляйте всё сразу.
- Не распределяйте нагрузку по большему числу ключей — они делят бюджет рабочего пространства.
- Нужно больше? Повысьте тариф или обсудите Enterprise с sales@dcision.io.
Лимиты Playground
У запусков в Playground свой потолок, отдельный от API: 30 запусков в минуту и 2 000 запусков в день на рабочее пространство. Сверх этого Playground отвечает 429 RATE_LIMITED; для больших объёмов используйте API-ключ.
Пропускная способность движка
У провайдера движка есть собственные лимиты на запросы и токены в секунду. На ключе движка Dcision их делят все рабочие пространства, поэтому Dcision сглаживает всплески: решение ждёт свободного слота в пределах своего timeoutMs, а не завершается ошибкой сразу. Если за это время слот не освобождается, вызов завершается ошибкой 503 ENGINE_RATE_LIMITED — это ошибка движка, которую можно повторять с backoff, а не 429 RATE_LIMITED вашего рабочего пространства. С вашим собственным ключом провайдера действуют лимиты вашего аккаунта у провайдера. См. Движки и BYOK.
Ошибки
Формат ошибок и все коды ошибок с HTTP-статусом, значением и тем, что делать, — а также какие ошибки можно безопасно повторять.
Идемпотентность
Безопасные повторы с заголовком Idempotency-Key — ключи резервируются до запуска, успешные вызовы повторяются из хранилища 24 часа, заголовок Idempotent-Replayed и IDEMPOTENCY_CONFLICT.