Arquivo grande demais

arquivo_grande_demais

O PDF passa do limite de 20,0 MB, ou a requisição passa de 28,0 MB.

O que aconteceu

O documento enviado é maior do que a plataforma aceita. O limite existe por um motivo operacional: o arquivo é lido inteiro para memória durante o processamento, e um upload muito grande degradaria o serviço para todos os clientes ao mesmo tempo.

Por que costuma acontecer

• O PDF passa de 20,0 MB. É o caso mais comum, e quase sempre vem de escaneamento em resolução alta demais para texto.
• Ou a requisição inteira passa de 28,0 MB: em arquivo_base64 o conteúdo cresce cerca de 33% em relação ao arquivo original, e o resto do JSON soma um pouco mais.

Como resolver

• Escaneie em 200 a 300 dpi, em tons de cinza. Contrato é texto: acima disso o arquivo cresce muito e não fica mais legível.
• Se o PDF veio de foto de celular, gere-o a partir do documento original em vez de fotografar.
• Use multipart/form-data com o campo arquivo em vez de arquivo_base64: evita os ~33% de crescimento do base64 e deixa mais folga.
• Documento muito extenso pode ser dividido — cada parte vira um documento, e cada um consome uma unidade da cota.

Enviando por multipart, sem o crescimento do base64

curl -X POST https://usesign.com.br/api/v1/documentos \
  -H "Authorization: Bearer $USESIGN_CHAVE" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F arquivo=@contrato.pdf \
  -F dados='{"nome":"Contrato","signatarios":[{"nome":"Maria de Souza",
             "documento":"11144477735","email":"maria@exemplo.com","papel":"contratante"}]}'

Relacionados

• arquivo_nao_e_pdf — O arquivo não é um PDF
• entrada_invalida — Entrada inválida

Ramifique sempre pelo campo codigo da resposta — ele é estável. Nunca pelo texto da mensagem nem por esta URL.