Vooraf controleren vóór het uploaden
Controleer geschiktheid voor PDF-bewerkingen, ondertekende metadata, batchlimieten en HQ-tegoedschattingen voordat je bestanden verzegelt of uploadt.
PDF-bewerkingen controleren zonder te uploaden#
POST /v1/preflight controleert een voorgestelde PDF-bewerking, metadata, instellingen, abonnementsbeperkingen en een indicatieve schatting van HQ-tegoed zonder opslag toe te wijzen, een taak te maken of tegoed af te schrijven. Geef format, size_bytes en page_count van elk bestand op. Authenticatie gebruikt een accountsessie of API-sleutel met taakrechten; beperkte anonieme verzoeken mogen saldi niet inzien.
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":{}}'Bekijk supported, eligible, can_proceed, blockers, quote en next_actions. Alleen een centraal door HQTools geverifieerd aanbod kan een blokkade oplossen waarvoor een aankoop mogelijk is. Een technisch niet-ondersteund verzoek mag geen betaalmuur tonen.
Uitvoering en beveiliging#
Snelheidsbeperkingen en strikte validatie beschermen het anonieme eindpunt. Een geslaagde voorafgaande controle reserveert geen tegoed, garandeert geen prijs en bewijst de inhoud van geüploade PDF's niet. Onderteken en upload rechtstreeks naar de opslag, maak de taak aan en laat de server echte documenten, rechten, quota en HQ-tegoed bij uitvoering opnieuw controleren.
De referentie-SDK's bieden preflight(request) in tien talen en de actuele OpenAPI-specificatie /openapi.json beschrijft de openbare contracten. Verwerk HTTP 422 (validatie), 429 (snelheidslimiet) en 503 (niet beschikbaar).
