Logo PDFHQ

Documenti

DocumentazioneGuida introduttiva

Verifica preliminare prima del caricamento

Verifica l'idoneità delle operazioni PDF, i metadati firmati, i limiti dei lotti e le stime dei crediti HQ prima di sigillare o caricare file.

Chiavi API lato server Caricamenti di archiviazione firmati

Convalida le operazioni PDF senza caricare file#

POST /v1/preflight verifica un'operazione PDF proposta, i metadati, le impostazioni, i limiti del piano e una stima indicativa dei crediti HQ senza allocare spazio, creare attività o addebitare crediti. Fornisci format, size_bytes e page_count per ogni file. L'autenticazione usa una sessione dell'account o una chiave API con permessi sulle attività; le richieste anonime limitate non possono leggere i saldi.

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":{}}'

Controlla supported, eligible, can_proceed, blockers, quote e next_actions. Solo un'offerta verificata centralmente da HQTools può risolvere un blocco acquistabile. Una richiesta tecnicamente non supportata non deve mostrare un paywall.

Esecuzione e sicurezza#

I limiti di frequenza e la verifica rigorosa delle richieste proteggono l'endpoint anonimo. Una verifica preliminare riuscita non prenota crediti, non garantisce il prezzo e non dimostra il contenuto dei PDF caricati. Firma e carica direttamente nello spazio di archiviazione, crea l'attività e lascia che il server ricontrolli documenti effettivi, diritti, quote e crediti HQ durante l'esecuzione.

Gli SDK di riferimento offrono preflight(request) in dieci linguaggi e la specifica OpenAPI aggiornata /openapi.json descrive i contratti pubblici. Gestisci le risposte HTTP 422 (convalida), 429 (limite di frequenza) e 503 (non disponibile).

Logo PDFHQ

Strumenti PDF e intelligenza documentale. Prepara, comprendi e lavora con i tuoi documenti.

© 2026 PDFHQ. Tutti i diritti riservati.