Как се броят заявките

Какво се брои за една заявка

• Всяка заявка към маршрут с данни — търсене, списък, документ, дело, фирма, снимка — е една заявка, колкото и резултати да върне.
• Всяка страница е отделна заявка. Делата на адвокат идват по 20 на страница: адвокат с 300 дела е 15 заявки.
• През /api/mcp месечната квота брои само успешното извикване на инструмент (tools/call) — една заявка за едно извикване. Извикване, което завърши с грешка, свързването и списъкът с инструменти не се броят в месечната квота, а лимитът в минута брои всяка заявка.
• Не се броят документацията (/api/docs, /api/openapi.json, /api/llms.txt) и справката за потреблението /api/usage — остатъкът се проверява и след изчерпана квота.
• Не се брои заявка с грешен или оттеглен ключ — тя получава 401.
• Заявката към REST API се брои, преди да бъде изпълнена: броят се и заявка, върната с грешка, и заявка, спряна от лимита в минута. Забавете заявките според заглавката Retry-After.
• Месечната квота е на организацията — всички ключове теглят от един месец, а оттеглянето на ключ не я нулира. Лимитите в минута са на ключ.

Когато достигнете лимита

Твърде бързо — лимитът в минута

Отговорът е 429 с код rate_limited и заглавка Retry-After — секундите до освобождаване на място. Всеки отговор носи X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset за Вашия прозорец.

{
  "type": "https://magistrat.bg/api/errors/rate_limited",
  "title": "Too Many Requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "the per-minute window is full",
  "retryAfterSeconds": 41,
  "limitScope": "api_key",
  "upgradeUrl": "https://magistrat.bg/developers/console/plan"
}

Свършил месец — квотата

Отговорът е 429 с код quota_exceeded, а Retry-After брои до първо число. Заявките спират на всички нива — надвишение не се таксува, така че сметката никога не е изненада. Повече заявки дава по-горно ниво — то важи в рамките на минута. Пишем Ви при 80 % от месечната квота и при първата заявка над нея.

{
  "type": "https://magistrat.bg/api/errors/quota_exceeded",
  "title": "Monthly quota exceeded",
  "status": 429,
  "code": "quota_exceeded",
  "detail": "developer plan: 5000 requests per calendar month (UTC) per organisation",
  "retryAfterSeconds": 1834117,
  "upgradeUrl": "https://magistrat.bg/developers/console/plan"
}

Квотата се подновява в 00:00 UTC на първо число всеки месец, независимо кога сте се абонирали; неизползваните заявки не се прехвърлят.