Direkte PDF-Uploads
Sichere signierte Speicher-Uploads, SHA-256-Checksummen, Upload-Abschluss und Ablauf.
Dokumentenbibliothek#
Nach dem Versiegeln eines Uploads registriere seine upload_id und seinen Titel mit POST /v1/workspace/documents. Die Bibliothek speichert eine Referenz mit Konto- und API-Schlüssel-Bereich, ohne die Datei zu kopieren oder ihre ursprüngliche Ablaufzeit zu verlängern.
Liste, benenne und entferne Referenzen unter /v1/workspace/documents. Vorschau- und Aktivitätsendpunkte überprüfen Eigentum und Ablauf erneut. PUT / {document_id}/retention akzeptiert einen retained_until-Zeitstempel, der die Verfügbarkeit nur verkürzen kann. Durch das Entfernen einer Referenz bleibt der ursprüngliche Upload unter seiner bestehenden Aufbewahrungsrichtlinie.
POST /{document_id}/handoff/task hängt die Quelle an eine Aufgabe an; /handoff/ai erfordert das normale Zitat, die ausdrückliche Zustimmung der externen KI und den Idempotency-Key; /handoff/signing erstellt einen Entwurf zur separaten Überprüfung und zum Senden. OAuth erfordert files.read oder files.write für Bibliotheksvorgänge, jobs.write für die Aufgabenübergabe, ai.write für die KI-Übergabe und Signaturen.write für die Signaturübergabe.
Dateizulassung#
Fordern Sie einen vorsignierten Upload an mit POST /v1/documents/uploads mit Dateiname, content_type=application/pdf, size_bytes und dem SHA-256-Hash (Kleinbuchstaben) der exakten Quelldaten. Die Antwort enthält eine S3 POST-URL und signierte Multipart-Formularfelder.
Sende alle zurückgegebenen Felder unverändert und die Datei an die S3-URL. Rufe dann auf POST /v1/documents/uploads/{upload_id}/complete um Größe und Metadaten zu verifizieren und das Objekt zu versiegeln. Nur bereite Uploads können an Tasks angehängt werden. Bevorzuge POST /v1/tasks/{task_id}/uploads und den zurückgegebenen Abschlusslink zum automatischen Anhängen der Datei.
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"}'Datenschutz und Limits#
Ein Task-Upload kann nur an einen Task angehängt werden. Upload-Tickets verfallen; Größe, PDF-Signatur und Digest müssen übereinstimmen. Signierte URLs nicht speichern oder sensible Dateiinhalte protokollieren. Kunden können ungenutzte Uploads löschen, bevor sie an einen Job übermittelt werden.
