PDF-pagina's organiseren API
Wijzig de volgorde van PDF-pagina's, roteer, dupliceer en verwijder deze in één beveiligde asynchrone taak.
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#
| Instelling | Typ | Gedrag |
|---|---|---|
| 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
# 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.
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