Logo PDFHQ

Documents

DocumentationMise en route

Démarrage rapide API

Votre première tâche de traitement PDFHQ utilisant un import signé, un fichier vérifié et une tâche asynchrone.

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

Première demande réussie#

Générez une clé API de projet HQTools sur le serveur. Démarrez une tâche, importez un PDF réel avec son nombre d'octets correct et son SHA-256, terminez l'importation, attachez son ID et mettez l'opération en file d'attente.

Programming language: cURL

Choisir une langue · faites défiler horizontalement pour les 10 langages SDK

API example · cURL
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"tool":"compress"}'

# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'

# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"compression_level":"recommended"}}'

curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'

After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.

All 10 SDKs ↓Procédure complète Python ↓ Procédure complète Bash/cURL ↓ Tous les points de terminaison → Importations directes → Gestion des erreurs →

Les packages téléchargeables générés couvrent uniquement le flux de travail des tâches. Les SDK de service complet nécessitent une spécification OpenAPI de runtime vérifiée ; les SDK de tâches Python, JavaScript et TypeScript diffusent les importations de fichiers ; les autres langues nécessitent des importations multipart signées implémentées par l'appelant.

Tentatives sûres et création de tâches idempotentes →

Exemples complets et prêts à télécharger : CLI Python et Bash/cURL . Ils s'arrêtent après citation sauf si vous approuvez explicitement le traitement, et prennent en charge la reprise d'une tâche existante après une réponse incertaine.

Séquence cURL de signature-importation complète
# 1. Start a task. Save the task_id from its JSON response.
curl -X POST https://api.pdfhq.io/v1/tasks \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"tool":"compress"}'

# 2. Start a task-scoped upload. Use real file size and SHA-256 values.
curl -X POST https://api.pdfhq.io/v1/tasks/TASK_ID/uploads \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"filename":"report.pdf","size_bytes":12345,"sha256":"ACTUAL_64_CHAR_DIGEST","content_type":"application/pdf"}'

# 3. POST signed "fields" plus binary file directly to returned S3 "url".
#    Then complete it; PDFHQ automatically attaches the verified file.
curl -X POST https://api.pdfhq.io/v1/tasks/TASK_ID/uploads/UPLOAD_ID/complete -H 'x-api-key: YOUR_API_KEY'

# 4. Queue work (safe to retry with IDENTICAL options), then poll until succeeded.
curl -X POST https://api.pdfhq.io/v1/tasks/TASK_ID/process \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"compression_level":"recommended"}}'
curl https://api.pdfhq.io/v1/tasks/TASK_ID -H 'x-api-key: YOUR_API_KEY'

# 5. Once succeeded, get a short-lived signed URL.
curl https://api.pdfhq.io/v1/tasks/TASK_ID/download-url -H 'x-api-key: YOUR_API_KEY'

Résultat réussi#

Réponse de démarrage de tâche 201 (IDs illustratifs)
{
  "task_id": "uuid",
  "tool": "compress",
  "status": "waiting",
  "upload_ids": [],
  "job_id": null,
  "progress": 0,
  "output_ready": false,
  "links": {
    "self": "/v1/tasks/uuid",
    "files": "/v1/tasks/uuid/files",
    "process": "/v1/tasks/uuid/process"
  }
}

La tâche progresse de l'attente à en file d'attente/en cours/réussie ou échouée. Lisez son statut avant de demander une URL de téléchargement.

Logo PDFHQ

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

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