API Firma PDF (Segni visibili)
Posiziona un nome digitato, una data o un'immagine di firma disegnata su un PDF utilizzando il ciclo di vita dell'attività misurata. Questo non verifica le identità o emette firme crittografiche supportate da certificati.
Semantica endpoint e attività#
Codice operazione: sign
Avvia questa operazione con POST /v1/tasks e il codice dello strumento mostrato sopra. Carica e allega i PDF di origine (o usa gli endpoint di caricamento con ambito task), quindi chiama POST /v1/tasks/{task_id}/process con impostazioni di operazione.
Aggiungi una firma visibile revisionata, iniziali o data ai documenti con il permesso del firmatario.
Input: Esattamente un PDF sigillato; 1–12 marchi; massimo 100 MiB e 500 pagine (i limiti del piano potrebbero essere inferiori). I documenti che contengono già firme digitali vengono rifiutati.
Configurazione e parametri aggiuntivi#
| Impostazione | Tipo | Comportamento |
|---|---|---|
| marksobbligatorio | object[] | 1–12 marchi; ognuno include pagina (basata su 1), x0, y0, x1, y1 in punti PDF in alto a sinistra e tipo: digitato, data o disegnato. I marchi digitati/data includono testo; i marchi disegnati includono byte PNG in base64 (senza prefisso URL dati). Immagini max 96 KiB, 1600 × 600 pixel. |
Le opzioni sono convalidate dall'API. Le impostazioni sconosciute e i valori non supportati restituiscono un errore invece di essere ignorati.
Sequenza di richiesta in corso#
Programming language: cURL
Scegli una lingua · scorri orizzontalmente per tutti i 10 linguaggi 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.
I pacchetti scaricabili generati coprono solo il flusso di lavoro dell'attività. Gli SDK full-service richiedono una specifica OpenAPI di runtime verificata; gli SDK delle attività Python, JavaScript e TypeScript trasmettono i caricamenti di file; gli altri linguaggi richiedono caricamenti multipart firmati implementati dal chiamante.
L'ID attività restituito viene utilizzato sia per il polling dello stato che per il recupero. Dopo il completamento dell'attività, richiedi un URL di output firmato anziché incorporare un segreto di download.
Output e dettagli importanti#
Nuovo PDF contenente segni di firma visibili nei rettangoli richiesti. Le pagine di origine e il testo originale rimangono accessibili.
Questa operazione NON crea un certificato digitale, una traccia di audit del destinatario, un'attestazione di conformità legale o una verifica dell'identità del firmatario. Le firme digitali PDF esistenti vengono rifiutate; le pagine di destinazione ruotate non sono supportate. Per flussi di lavoro di firma del destinatario di livello aziendale, integra un provider dedicato.
Errori, tentativi e fatturazione