Logo PDFHQ

Documentos

DocumentaçãoPrimeiros passos

Envios diretos de PDF

Uploads de armazenamento pré-assinado seguro, checksums SHA-256, conclusão de upload e expiração.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Biblioteca de documentos#

Após selar um upload, registre seu upload_id e título com POST /v1/workspace/documents. A biblioteca armazena uma referência com escopo de conta e chave de API, sem copiar o arquivo ou estender sua expiração original.

Listar, renomear e remover referências em /v1/workspace/documents. Pontos finais de visualização e atividade revalidam propriedade e validade. PUT / {document_id}/retention aceita um carimbo de data/hora retained_until que só pode reduzir a disponibilidade. A remoção de uma referência deixa o upload original sob a política de retenção existente.

POST /{document_id}/handoff/task anexa a origem a uma tarefa; /handoff/ai requer cotação normal, consentimento externo explícito da IA ​​e chave de idempotência; /handoff/signing cria um rascunho para revisão e envio separados. OAuth requer files.read ou files.write para operações de biblioteca, jobs.write para transferência de tarefas, ai.write para transferência de IA e subscriptions.write para transferência de assinatura.

Admissão de arquivo#

Solicite um upload pré-assinado usando POST /v1/documents/uploads com nome de ficheiro, content_type=application/pdf, size_bytes e o SHA-256 em minúsculas dos bytes de origem exatos. A resposta contém um URL POST S3 e campos de formulário multipart assinados.

Envie todos os campos retornados sem modificações e o arquivo para a URL S3. Em seguida, chame POST /v1/documents/uploads/{upload_id}/complete para verificar tamanho e metadados e selar o objeto. Apenas uploads prontos podem ser anexados a tarefas. Prefira POST /v1/tasks/{task_id}/uploads e a ligação de conclusão devolvida para anexar automaticamente o ficheiro.

cURL
curl -X POST https://api.pdfhq.io/v1/documents/uploads \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"filename":"report.pdf","content_type":"application/pdf","size_bytes":12345,"sha256":"ACTUAL_64_CHAR_DIGEST"}'

Privacidade e limites#

Um upload de tarefa pode ser anexado a apenas uma tarefa. Os tíquetes de upload expiram; tamanho, assinatura do PDF e resumo devem corresponder. Não persista URLs assinados nem registre conteúdo de arquivo confidencial. Os clientes podem excluir uploads não utilizados antes de serem enviados para um trabalho.

Logo PDFHQ

Ferramentas PDF e inteligência de documentos. Prepare, compreenda e trabalhe com seus documentos.

© 2026 PDFHQ. Todos os direitos reservados.