Caricamenti PDF diretti
Caricamenti di archiviazione prescritti sicuri, checksum SHA-256, completamento caricamento e scadenza.
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 -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.
