PDF-Duplex-Seitenreihenfolge

Eine Null-Seitenzahl wird mit invalid_input abgelehnt.

Was Duplex an langer und kurzer Kante für die Seitenreihenfolge bedeutet

Ist die Seitenzahl ungerade, hat das letzte Blatt eine bedruckte Vorderseite und eine leere Rückseite — der Prüfer meldet das mit blank_back_last true und lässt back_page am letzten Blattobjekt weg, statt eine Phantomseite zu erfinden. Der Modus long_edge (auch mit buchartigen Aliassen akzeptiert) markiert jede Seite upright: wenden Sie das Blatt an der langen Kante und die Rückseite liest sich korrekt, ohne das Papier um einhundertachtzig Grad zu drehen. Der Modus short_edge (kalenderartige Aliasse) markiert jede Rückseite als rotated_180: wenden Sie an der kurzen Kante und der Rückseiteninhalt steht relativ zur Vorderseite auf dem Kopf, wenn Sie den Stapel ohne dieses Wenden halten.

Eingabevertrag, Antwortform und Fehlerverhalten

Negative Zählungen werden ebenfalls abgelehnt. Kombinieren Sie die Antwort mit eigenen N-up- oder Booklet-Impositionswerkzeugen, wenn Sie mehr als die einfache Duplexpaarung brauchen; dieser Endpunkt beantwortet nur die Blatt-Seiten-Ordnung des Standard-Duplex. Senden Sie einen JSON-Körper mit zwei Pflichtfeldern. page_count ist eine nichtnegative ganze Zahl (Aliasse pages, n, count); sie muss ganzzahlig sein, weil man keine Bruchseite drucken kann. duplex_mode ist eine Zeichenkette, normalisiert zu long_edge oder short_edge (Aliasse mode, flip, binding). Akzeptierte Schreibweisen für lange Kante umfassen long_edge, long-edge, longedge, flip_long, long und book; für kurze Kante short_edge, short-edge, shortedge, flip_short, short und calendar. Fehlende Felder, nicht endliche Zahlen, Nicht-Ganzzahlen und unbekannte Moduszeichenketten scheitern mit invalid_input und werden nicht berechnet. Ein page_count von null wird ausdrücklich abgelehnt mit der klaren Meldung, dass eine positive Seitenzahl nötig ist — leere Dokumente haben keine Blattkarte. Bei Erfolg spiegelt der Körper page_count und den normalisierten duplex_mode wider, meldet sheet_count und blank_back_last, listet pages als Objekte mit page, sheet, side (front oder back) und orientation (upright oder rotated_180), listet sheets mit sheet und front_page sowie optionalem back_page und back_orientation, wenn eine Rückseite existiert, und enthält einen kurzen summary-String für Protokolle und Oberfläche. Beispiel: fünf Seiten im Modus long_edge ergeben drei Blätter, Seiten eins bis fünf gemappt Vorder-Rück-Vorder-Rück-Vorderseite, blank_back_last true und jede Orientierung upright. Dieselben fünf Seiten in short_edge behalten die gleiche Blattpaarung, markieren aber die Seiten zwei und vier als rotated_180.

Wo eine API zur Duplex-Seitenreihenfolge ihren Nutzen hat

Barrierefreiheits- und Finishing-Teams, die fertige Stapel zum Binden wenden, können zeigen, welche Seiten im short-edge-Modus invertiert erscheinen, bevor jemand das Fach lädt. Weil die Implementierung reines Parse-Tier-A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis ohne Modell-Tokens und ohne ausgehendes Netz; fehlgeschlagene Validierung wird nicht berechnet. Druckräume und Managed-Print-Dienste nutzen einen Prüfer der Duplex-Seitenreihenfolge, bevor sie Aufträge mit Hunderten von Seiten freigeben, damit Bediener Bestände (sheet_count) und leere Rückseiten der letzten Blätter bestätigen können. Büroautomatisierung, die Rechnungen oder Pakete beidseitig druckt, kann blank_back_last und Orientierung in Tests prüfen statt bei jedem Treiber-Preset-Wechsel auf ein physisches Muster zu setzen. Autoren von PDF-Pipelines, die Umschalter long-edge versus short-edge in einer Oberfläche anbieten, können die Blattkarte kostenlos im Browser vorab ansehen und denselben Vertrag aus einem Worker zu $0.002 pro erfolgreicher Anfrage aufrufen, wenn der Auftrag in die Warteschlange geht.