Logo PDFHQ

Documents

DocumentationMise en route

Vérification préalable avant le téléversement

Vérifier l’éligibilité d’une opération PDF, les métadonnées signées, les limites de lot et les estimations de crédits HQ avant de sceller ou téléverser des fichiers.

Clés API côté serveur Importations de stockage signées

Valider les opérations PDF sans téléversement#

POST /v1/preflight valide l’opération PDF proposée, les métadonnées, les paramètres, les restrictions du forfait et une estimation indicative des crédits HQ sans allouer de stockage, créer de tâche ni débiter de crédits. Indiquez le format, size_bytes et page_count de chaque fichier. L’authentification utilise une session de compte ou une clé API autorisée à gérer les tâches ; les requêtes anonymes limitées ne peuvent pas consulter les soldes.

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

Examinez supported, eligible, can_proceed, blockers, quote et next_actions. Seule une offre vérifiée par HQTools peut résoudre un blocage nécessitant un achat. Une demande techniquement non prise en charge ne doit pas afficher de fenêtre de paiement.

Exécution et sécurité#

Les limites de débit et la validation stricte des requêtes protègent le point d’accès anonyme. Une vérification préalable réussie ne réserve pas de crédits, ne fixe pas de prix et ne prouve pas le contenu des PDF. Signez et téléversez directement vers le stockage, créez la tâche et laissez le serveur revérifier les documents réels, les droits, les quotas et les crédits HQ à l’exécution.

Les SDK de référence exposent preflight(request) dans dix langages et le document OpenAPI actif /openapi.json décrit les contrats publics. Gérez les réponses HTTP 422 (validation), 429 (limite de débit) et 503 (indisponibilité).

Logo PDFHQ

Outils PDF et intelligence documentaire. Préparez, comprenez et travaillez avec vos documents.

© 2026 PDFHQ. Tous droits réservés.