API Assinar PDF (Marcas Visíveis)
Coloque um nome digitado, data ou imagem de assinatura desenhada em um PDF usando o ciclo de vida da tarefa medida. Isso não verifica identidades ou emite assinaturas criptográficas com suporte de certificado.
Semântica de endpoint e tarefa#
Código de operação: sign
Inicie esta operação com POST /v1/tasks e o código da ferramenta mostrado acima. Envie e anexe PDFs de origem (ou use endpoints de upload com escopo de tarefa), depois chame POST /v1/tasks/{task_id}/process com configurações de operação.
Adicione uma assinatura visível revisada, iniciais ou data aos documentos com permissão do signatário.
Entradas: Exatamente um PDF lacrado; 1–12 marcas; máximo 100 MiB e 500 páginas (os limites do plano podem ser menores). Documentos que já contêm assinaturas digitais são rejeitados.
Configuração e parâmetros extras#
| Configuração | Tipo | Comportamento |
|---|---|---|
| marksobrigatório | object[] | 1–12 marcas; cada uma inclui página (baseada em 1), x0, y0, x1, y1 em pontos PDF do canto superior esquerdo e tipo: digitado, data ou desenhado. Marcas digitadas/data incluem texto; marcas desenhadas incluem bytes PNG em base64 (sem prefixo de URL de dados). Imagens máx. 96 KiB, 1600 × 600 pixels. |
As opções são validadas pela API. Configurações desconhecidas e valores não suportados retornam um erro em vez de serem ignorados.
Sequência de pedido em funcionamento#
Programming language: cURL
Escolha um idioma · role horizontalmente para todos os 10 idiomas de SDK
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"tool":"sign"}'
# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'
# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -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"}]}}'
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.
Pacotes baixáveis gerados cobrem apenas o fluxo de trabalho da tarefa. SDKs de serviço completo requerem uma especificação OpenAPI de tempo de execução verificada; os SDKs de tarefa Python, JavaScript e TypeScript transmitem uploads de arquivo; os outros idiomas requerem uploads multipart assinados implementados pelo chamador.
O ID da tarefa retornado é usado tanto para sondagem de status quanto para recuperação. Após a tarefa ter sucesso, solicite uma URL de saída assinada em vez de incorporar um segredo de download.
Saída e detalhes importantes#
Novo PDF contendo marcas de assinatura visíveis nos retângulos solicitados. Páginas de origem e texto original permanecem acessíveis.
Esta operação NÃO cria um certificado digital, trilha de auditoria do destinatário, atestado de conformidade legal ou verificação de identidade do signatário. Assinaturas digitais de PDF existentes são rejeitadas; páginas de destino rotacionadas não são suportadas. Para fluxos de trabalho de assinatura de destinatário de nível empresarial, integre um provedor dedicado.
Erros, tentativas e faturamento