PDFHQ-Logo

Dokumente

DokumentationErste Schritte

Vorabprüfung vor dem Hochladen

PDF-Berechtigung, signierte Metadaten, Stapelgrenzen und HQ-Guthabenschätzungen vor dem Versiegeln oder Hochladen prüfen.

Server-seitige API-Schlüssel Signierte Speicher-Uploads

PDF-Vorgänge ohne Hochladen prüfen#

POST /v1/preflight prüft den geplanten PDF-Vorgang, Metadaten, Einstellungen, Tarifbeschränkungen und eine unverbindliche HQ-Guthabenschätzung, ohne Speicher zuzuweisen, einen Auftrag anzulegen oder Guthaben abzubuchen. Geben Sie für jede Datei format, size_bytes und page_count an. Die Authentifizierung erfolgt über eine Kontositzung oder einen API-Schlüssel mit Auftragsberechtigungen; eingeschränkte anonyme Anfragen dürfen keine Guthabenstände einsehen.

cURL
curl -X POST 'https://api.pdfhq.io/v1/preflight'   -H 'Content-Type: application/json'   -H 'x-api-key: YOUR_API_KEY'   -d '{"operation":"merge","inputs":[{"format":"pdf","size_bytes":51200,"page_count":2},{"format":"pdf","size_bytes":40960,"page_count":3}],"file_count":2,"settings":{}}'

Prüfen Sie supported, eligible, can_proceed, blockers, quote und next_actions. Nur ein zentral von HQTools bestätigtes Angebot kann eine kaufbare Sperre beheben. Bei einer technisch nicht unterstützten Anfrage darf keine Bezahlschranke erscheinen.

Ausführung und Sicherheit#

Ratenbegrenzung und strenge Anfrageprüfung schützen den anonymen Endpunkt. Eine erfolgreiche Vorabprüfung reserviert kein Guthaben, garantiert keinen Preis und bestätigt nicht den Inhalt der hochgeladenen PDFs. Signieren und laden Sie direkt in den Speicher hoch, erstellen Sie den Auftrag und lassen Sie den Server die tatsächlichen Dokumente, Berechtigungen, Quoten und HQ-Guthaben bei der Ausführung erneut prüfen.

Die Referenz-SDKs stellen preflight(request) in zehn Sprachen bereit; das aktuelle OpenAPI-Dokument /openapi.json beschreibt die öffentlichen Verträge. Behandeln Sie HTTP 422 (Validierung), 429 (Ratenlimit) und 503 (nicht verfügbar).

PDFHQ-Logo

PDF-Werkzeuge und Dokumentenanalyse. Dokumente vorbereiten, verstehen und bearbeiten.

© 2026 PDFHQ. Alle Rechte vorbehalten.