API
Limites de requisição
Limites por credencial e por rota, gerados da matriz de credenciais.
Gerado da matriz de credenciais · versão 1 · sha
9d2b630103a5. Não edite à mão: a fonte ésrc/credential-matrix.tsno engine.
Rotas autenticadas contam por credencial: o balde é o sha256 do bearer inteiro, então dois tokens nunca dividem limite. Rotas públicas contam pelo IP real do cliente. A janela é deslizante.
| Rotas | Chave do balde | Limite | Janela | Ajuste no servidor | Ao estourar |
|---|---|---|---|---|---|
Rotas públicas e sem bearer (*) | IP real do cliente (CF-Connecting-IP) | 60 | 60 s | VALORBRAIN_RATE_LIMIT_MAX | 429 com retry_after_ms |
Rotas autenticadas (*) | sha256 do bearer inteiro (dois tokens nunca dividem balde); a credencial de plataforma, por tenant de destino. Isenção só para api_tokens.is_admin com VALORBRAIN_RATE_LIMIT_EXEMPT=true | 300 | 60 s | VALORBRAIN_RATE_LIMIT_AUTH_MAX | 429 com retry_after_ms |
Bearer do engine que não resolve (*) | IP real do cliente (CF-Connecting-IP); estourado, responde 429 sem consultar o banco | 60 | 60 s | VALORBRAIN_RATE_LIMIT_AUTH_FAILURE_MAX | 429 com retry_after_ms |
Reemissão do token MCP do signup (POST /api/v1/agents/mcp-token) | Tenant da chave vb_agent_ | 3 | 60 s | VALORBRAIN_RATE_LIMIT_AGENT_REISSUE_MAX | 429 com retry_after_ms |
Busca (/search, /api/v1/search, /retrieve) | sha256 do bearer | 120 | 60 s | VALORBRAIN_RATE_LIMIT_SEARCH_MAX | 429 com retry_after_ms |
Signup de agente (POST /api/v1/agents/signup) | IP real do cliente; também 5 signups por IP por dia | 10 | 60 s | VALORBRAIN_RATE_LIMIT_SIGNUP_MAX | 429 com retry_after_ms |
Registro dinâmico OAuth (POST /oauth/register) | IP real do cliente | 10 | 60 s | VALORBRAIN_RATE_LIMIT_OAUTH_MAX | 429 rate_limited com Retry-After |
Ingest do SaaS (POST https://valorbrain.valor.digital/api/v1/ingest) | Credencial (token vbm_ ou chave fk_) | 200 | 60 s | fixo no código | 429 Rate limit exceeded (200 req/min) |
Respostas (/ask) (POST /ask) | Tenant (padrão do plano em burst_answers_per_min); teto mensal opcional do cliente | 60 | 60 s | VALORBRAIN_TENANT_BURST_DEFAULT | 429 answer_burst_exceeded com Retry-After; 429 answer_cap_reached no teto mensal |
Por credencial
| Credencial | Limite |
|---|---|
Token MCP (vbm_) | authenticated e search, por sha256 do token |
Chave de conta de agente (vb_agent_) | authenticated e search, por sha256 da chave |
Chave de serviço (vb_) | authenticated e search, por sha256 da chave |
Chave de ingest do workspace (fk_) | saas_ingest, por credencial |
| Sessão do painel | Limites do app |
Respostas 429 estão no catálogo de erros.