Envios diretos de PDF
Uploads de armazenamento pré-assinado seguro, checksums SHA-256, conclusão de upload e expiração.
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 -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.
