Limites e cotas

Tamanhos, prazos, limites por minuto e por sessão.

Resumo#

Limite	Valor	O que acontece ao passar
Requisições por minuto (por cliente)	Definido no seu plano	`429 rate_limited`, com `Retry-After` (segundos).
Cota mensal de assinaturas concluídas	Definida no seu plano (opcional)	`403 quota_exceeded`. Em lote, o lote inteiro precisa caber na cota restante.
Tamanho de cada PDF (envio `multipart`, o recomendado)	30 MiB	`413 payload_too_large`.
Corpo de uma chamada JSON (PDF em base64)	32 MiB no total, o que dá cerca de 24 MiB de PDF (o base64 aumenta o tamanho em um terço)	`413 payload_too_large`. Acima disso, use o `multipart`.
Tamanho total de um envio `multipart`	256 MiB	`413 payload_too_large`.
Documentos por lote	50	`400 invalid_request`.
Validade do `token` da sessão	15 minutos desde o início, renovável com `POST .../extend` até 60 minutos desde o início	`404 token_not_found`: reinicie a assinatura. Depois do teto de 60 minutos, `409` ao renovar.
Sessão retida com `Idempotency-Key`	No mínimo 5 minutos depois do `complete` (até o fim do prazo ou o `DELETE`)	Some sozinha; libere com `DELETE`.
Tempo total de um envio `multipart`	10 minutos	`408 upload_timeout`: a sessão é cancelada; envie de novo.
Sessões abertas ao mesmo tempo, por cliente	Cerca de 100, e um teto de bytes por cliente	`429 tenant_storage_limit`, com `Retry-After`.
Respostas `inline` grandes repetidas ao mesmo tempo	Poucas por vez	`429`, com `Retry-After`: a conclusão não foi executada de novo; tente mais tarde.
Espaço em disco temporário do servidor	Global e por cliente	`507 storage_full` (global) ou `429 tenant_storage_limit` (do cliente).

Sessões concluídas contam até serem apagadas#

Uma sessão concluída continua ocupando uma vaga do seu cliente até o DELETE ou o fim do prazo (15 minutos). Quem não apaga fica limitado a cerca de 100 assinaturas a cada 15 minutos.

Chame DELETE /v1/pades-signatures/{token} assim que guardar o PDF. O SDK JavaScript faz isso sozinho. No cliente PHP, completeSafely faz no modo inline; no modo link, chame discard depois de baixar. Veja Sessões.

Como a cobrança conta#

Cada documento concluído é uma transação. Num lote de 10 PDFs, são 10.
As verificações de assinatura (/v1/signature-verifications) contam à parte, com preço próprio no plano.
Cada login por certificado concluído conta como uma transação certificate_authentication, com preço próprio no plano.
Sessões iniciadas e não concluídas não são cobradas.
O consumo do mês aparece no painel, em Uso e Faturas.

Boas práticas#

Ao receber 429, espere o Retry-After antes de tentar de novo. Não repita imediatamente.
Prefira o multipart para qualquer PDF acima de alguns megabytes.
Num lote grande, divida em lotes menores se o envio passar de alguns minutos.

ShieldSign PKI · Shield Certificadora · contato@shieldcertificadora.com.br · Privacidade