Zum Hauptinhalt springen

Nächstes Tool finden

Dokumentation/API/PDF-API: verbinden, teilen, drehen, komprimieren
API

PDF-API: verbinden, teilen, drehen, komprimieren

Führen Sie mehrere PDFs zusammen, extrahieren Sie Seiten, drehen und komprimieren Sie PDFs in der Cloud – mit einem einzigen Endpunkt.

Kurze Antwort

Senden Sie POST /api/v1/pdf-job/ mit der operation merge, split, rotate oder compress. Übergeben Sie für merge sourceKeys (in der gewünschten Reihenfolge), für die anderen Operationen einen einzelnen sourceKey; split erwartet nullbasierte Seitennummern in "pages", rotate erwartet "degrees" mit 90, 180 oder 270. Die Dateien stammen aus einem Direkt-Upload, und das Ergebnis ist ein neuer PDF-Job, den Sie wie jeden anderen abfragen.

Operationen

Die Dateien müssen bereits im Speicher Ihres Kontos liegen: Laden Sie sie zuerst hoch und verwenden Sie die zurückgegebenen Werte von objectKey.

operationEingabeZusätzliche Felder
mergesourceKeys: 2 oder mehr PDFs, in der gewünschten Reihenfolge—
splitsourceKeypages: nullbasiertes Array, z. B. behält [0, 1, 4] die Seiten 1, 2 und 5
rotatesourceKeydegrees: 90, 180 oder 270
compresssourceKey— (Ghostscript-Profil "ebook", Bilder mit 150 dpi)

Zwei hochgeladene PDFs zusammenführen

Um PDFs zusammenzuführen, die bereits online sind, senden Sie POST /api/v1/merge/ mit einem "files"-Array aus 2–20 PDF-URLs in der gewünschten Reihenfolge. Das kostet 1 Credit und liefert das zusammengeführte PDF direkt in der Antwort statt eines Jobs, was in No-Code-Tools praktisch ist.

curl -X POST 'https://maxscanner.app/api/v1/pdf-job/' \
  -H "Authorization: Bearer $MAXSCANNER_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: pack-8812-merge' \
  -d '{ "operation": "merge", "filename": "pack.pdf", "sourceKeys": ["users/<id>/media/inbox/…-cover.pdf", "users/<id>/media/inbox/…-contract.pdf"] }'

Limits und Verhalten

Jede Eingabedatei darf bis zu 100 MB groß sein, ein Job insgesamt bis zu 150 MB. Die Komprimierung rechnet Bilder auf etwa 150 dpi um, was für E-Mails und Uploads gut passt; PDFs, die bereits klein sind und überwiegend Text enthalten, schrumpfen möglicherweise kaum. Verschlüsselte PDFs müssen zuerst entsperrt werden.

Häufige Fragen

Sind Seitennummern nullbasiert?

In der API ja: [0] ist die erste Seite. Die Tools auf der Website zählen Seiten ab 1.

Kann ich auf eine exakte Größe komprimieren?

Nicht mit diesem Endpunkt. Er wendet ein einziges ausgewogenes Profil an; für exakte Zielgrößen bietet die Website ein Tool zum Komprimieren auf eine bestimmte Dateigröße.

Verwandte Anleitungen