PDFHQ-logo

Documenten

DocumentatiePDF-bewerkingen

PDF-pagina's organiseren API

Wijzig de volgorde van PDF-pagina's, roteer, dupliceer en verwijder deze in één beveiligde asynchrone taak.

Server-side API-sleutels Ondertekende opslagupload

Eindpunt- en taaksemantiek#

Bewerkingscode: organize

Start deze bewerking met POST /v1/tasks en de hierboven weergegeven toolcode. Upload en voeg bron-PDF's toe (of gebruik taakgerelateerde upload-eindpunten), vervolgens roep aan POST /v1/tasks/{task_id}/process met bewerkingsinstellingen.

Stel een document samen of rangschik het opnieuw zonder elke pagina in te scannen of opnieuw te uploaden.

Invoer: Één geverifieerde PDF, maximaal 500 pagina's en tot 500 uitvoerpagina's; planlimieten kunnen lager zijn.

Configuratie en extra parameters#

InstellingTypGedrag
pagesverplicht {source:number,rotation:0|90|180|270}[]Uitvoerreeks, 1-gebaseerde bronnummers van pagina's. Herhaalde bronnen dupliceren; afwezige bronnen verwijderen. Rotatie is met de klok mee en relatief ten opzichte van de oorspronkelijke rotatie.

Opties worden gevalideerd door de API. Onbekende instellingen en niet-ondersteunde waarden retourneren een fout in plaats van te worden genegeerd.

Werkende aanvraagvolgorde#

Programming language: cURL

Kies een taal · scroll horizontaal voor alle 10 SDK-talen

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

# 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":{"pages":[{"source":3,"rotation":90},{"source":1,"rotation":0}]}}'

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 ↓Volledige Python-walkthrough ↓ Volledige Bash/cURL-walkthrough ↓ Alle eindpunten → Directe uploads → Foutafhandeling →

Gegenereerde downloadbare pakketten dekken alleen de taakwerkstroom. Full-service SDK's vereisen een geverifieerde runtime OpenAPI-specificatie; de Python-, JavaScript- en TypeScript-taak-SDK's streamen bestandsuploads; de andere talen vereisen ondertekende multipart-uploads geïmplementeerd door de aanroeper.

De geretourneerde taak-ID wordt gebruikt voor zowel statuspolling als ophalen. Nadat de taak is voltooid, vraagt u een ondertekende uitvoer-URL aan in plaats van een downloadgeheim in te sluiten.

Uitvoer en belangrijke details#

Nieuwe PDF in aangevraagde paginavolgorde; origineel behouden volgens retentiebeleid.

Herschrijven verbreekt cryptografische PDF-handtekeningen. Ondertekende PDF's worden afgewezen. AcroForm-documenten en ondertekende PDF's worden afgewezen. Interne koppelingen en bladwijzers kunnen niet overleven bij herstructurering van pagina's; controleer vóór distributie.

Fouten, nieuwe pogingen en facturering
PDFHQ-logo

PDF-tools en documentintelligentie. Bereid, begrijp en werk met uw documenten.

© 2026 PDFHQ. Alle rechten voorbehouden.