Assinaturas PDF: marcas visíveis vs assinatura eletrônica
Compreenda os limites entre colocar sua própria marca manuscrita/digitada, solicitar assinaturas de terceiros e assinatura digital com certificado.
Três recursos diferentes de assinatura de PDF#
Assinatura visível (implementada): use o API Assinar PDF para colocar nomes digitados, datas ou assinaturas PNG fornecidas pelo usuário em um documento autorizado. A saída é um novo PDF com marcas visíveis, não uma assinatura criptográfica ou verificada por identidade.
Solicitações de assinatura (integração de sandbox implementada): envie um documento para um ou mais destinatários, aprove explicitamente o envio, rastreie os estados visualizado/assinado/recusado e recupere um PDF concluído após o processamento do provedor. A API de envelope eSign do PDFHQ usa Dropbox Sign em modo de teste. O envio em produção e os envelopes legalmente vinculativos ainda não estão habilitados.
Assinatura com suporte de certificado (não implementada): operações de certificado PDF assinado, como PAdES e assinaturas eletrônicas qualificadas, exigem certificados confiáveis e, para assinaturas qualificadas, um provedor credenciado. Marcas PDF visíveis não podem substituir essas garantias.
Solicitação de tarefa atual#
curl -X POST 'https://api.pdfhq.io/v1/tasks' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"tool":"sign"}'
# Envie e confirme cada PDF; POST /tasks/TASK_ID/files com seu upload_id.
# Depois processe esta tarefa:
curl -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"options":{"marks":[{"kind":"typed","page":1,"x0":72,"y0":650,"x1":320,"y1":715,"text":"Jane Doe"}]}}'Coloque até 12 marcas em páginas não rotacionadas. A API valida geometria, tipo de imagem e dimensões, retorna erros claros e rejeita documentos com assinaturas digitais existentes para evitar invalidá-las inadvertidamente.
Privacidade, créditos e considerações legais#
PDFHQ usa a tarefa de processamento ordinária HQ Credit-backed para assinatura visível. As imagens de assinatura viajam através do manifesto de tarefa autenticado e do worker privado, não através de um provedor terceirizado separado. Não use estas marcas para se passar por um signatário.
A validade da assinatura eletrônica depende do contexto e da jurisdição. Para contratos regulados ou transfronteiriços, consulte um advogado e use um provedor que suporte o nível de evidência, verificação de identidade e assinatura necessários.
