Logo PDFHQ

Documenti

DocumentazioneGuida introduttiva

Caricamenti PDF diretti

Caricamenti di archiviazione prescritti sicuri, checksum SHA-256, completamento caricamento e scadenza.

Chiavi API lato server Caricamenti di archiviazione firmati

Libreria documenti#

Dopo aver sigillato un caricamento, registra il suo upload_id e il titolo con POST /v1/workspace/documents. La libreria memorizza un riferimento con ambito account e chiave API, senza copiare il file o estendere la sua scadenza originale.

Elenca, rinomina e rimuovi riferimenti in /v1/workspace/documents. Gli endpoint di anteprima e attività verificano nuovamente la proprietà e la scadenza. PUT / {document_id}/retention accetta un timestamp retained_until che può solo ridurre la disponibilità. La rimozione di un riferimento lascia il caricamento originale soggetto ai criteri di conservazione esistenti.

POST /{document_id}/handoff/task collega la fonte a un'attività; /handoff/ai richiede le virgolette normali, il consenso esplicito dell'IA esterna e la chiave di idempotenza; /handoff/signing crea una bozza per la revisione e l'invio separati. OAuth richiede files.read o files.write per le operazioni della libreria, jobs.write per il trasferimento delle attività, ai.write per il trasferimento AI e Signatures.write per il trasferimento della firma.

Ammissione file#

Richiedi un caricamento prescritto utilizzando POST /v1/documents/uploads con filename, content_type=application/pdf, size_bytes e l'SHA-256 minuscolo dei byte sorgente esatti. La risposta contiene un URL POST S3 e campi modulo multipart firmati.

Invia tutti i campi restituiti senza modifiche e il file all'URL S3. Quindi chiama POST /v1/documents/uploads/{upload_id}/complete per verificare dimensioni e metadati e sigillare l'oggetto. Solo i caricamenti pronti possono essere allegati alle attività. Preferisci POST /v1/tasks/{task_id}/uploads e il link di completamento restituito per allegare automaticamente il file.

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"}'

Privacy e limiti#

Un caricamento di attività può essere allegato a una sola attività. I biglietti caricati scadono; dimensione, firma PDF e digest devono corrispondere. Non rendere persistenti gli URL firmati e non registrare i contenuti sensibili dei file. I clienti possono eliminare i caricamenti inutilizzati prima che vengano inviati a un lavoro.

Logo PDFHQ

Strumenti PDF e intelligenza documentale. Prepara, comprendi e lavora con i tuoi documenti.

© 2026 PDFHQ. Tutti i diritti riservati.