Directe PDF-uploads
Veilige voorgeparafeerde opslagupload, SHA-256-checksums, uploadvoltooiing en vervaldatum.
Documentbibliotheek#
Na het verzegelen van een upload registreert u de upload_id en titel met POST /v1/workspace/documents. De bibliotheek slaat een account- en API-sleutelverwijzing op, zonder het bestand te kopiëren of de oorspronkelijke vervaldatum te verlengen.
Vermeld, hernoem en verwijder referenties onder /v1/workspace/documents. Voorbeeld- en activiteitseindpunten controleren eigendom en vervaldatum opnieuw. PUT / {document_id}/retention accepteert een retained_until-tijdstempel die de beschikbaarheid alleen maar kan verkorten. Als u een referentie verwijdert, blijft de oorspronkelijke upload onder het bestaande bewaarbeleid.
POST /{document_id}/handoff/task koppelt de bron aan een taak; /handoff/ai vereist het normale citaat, expliciete externe AI-toestemming en Idempotency-Key; /handoff/signing creëert een concept voor afzonderlijke controle en verzending. OAuth vereist files.read of files.write voor bibliotheekbewerkingen, jobs.write voor taakoverdracht, ai.write voor AI-overdracht en signatures.write voor ondertekeningoverdracht.
Bestandstoelating#
Vraag een voorgeparafeerde upload aan met POST /v1/documents/uploads met bestandsnaam, content_type=application/pdf, size_bytes en de SHA-256 in kleine letters van de exacte bronbytes. Het antwoord bevat een S3 POST-URL en ondertekende multipart-formuliervelden.
Stuur alle geretourneerde velden ongewijzigd en het bestand naar de S3-URL. Roep vervolgens aan POST /v1/documents/uploads/{upload_id}/complete om grootte en metagegevens te verifiëren en het object af te sluiten. Alleen gereed geüploade bestanden kunnen aan taken worden gekoppeld. Geef de voorkeur aan POST /v1/tasks/{task_id}/uploads en de geretourneerde voltooiingskoppeling om het bestand automatisch bij te voegen.
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 en limieten#
Een taakupload kan aan slechts één taak worden gekoppeld. Upload-tickets verlopen; grootte, PDF-handtekening en digest moeten overeenkomen. Bewaar ondertekende URL's niet en registreer geen gevoelige bestandsinhoud. Klanten kunnen ongebruikte uploads verwijderen voordat deze aan een taak worden ingediend.
