Ordine pagine PDF fronte-retro

Un conteggio zero viene rifiutato con invalid_input.

Cosa significano fronte-retro bordo lungo e bordo corto per l'ordine delle pagine

Quando il conteggio è dispari, l'ultimo foglio ha fronte stampato e retro bianco: il controllo lo indica con blank_back_last true e omette back_page sull'oggetto di quel foglio invece di inventare una pagina fantasma. La modalità long_edge (accettata anche con alias stile libro) segna ogni lato upright: ribalti il foglio sul bordo lungo e il retro si legge correttamente senza ruotare la carta di centottanta gradi. La modalità short_edge (alias stile calendario) segna ogni retro come rotated_180: ribalti sul bordo corto e il contenuto del retro è capovolto rispetto al fronte se tiene la pila senza quel ribaltamento.

Contratto di ingresso, forma della risposta e comportamento di errore

Anche i conteggi negativi sono rifiutati. Invii un corpo JSON con due campi obbligatori. page_count è un intero non negativo (alias pages, n, count); deve essere un numero intero perché non si stampa una frazione di pagina. duplex_mode è una stringa normalizzata a long_edge o short_edge (alias mode, flip, binding). Grafie accettate per bordo lungo includono long_edge, long-edge, longedge, flip_long, long e book; per bordo corto: short_edge, short-edge, shortedge, flip_short, short e calendar. Campi mancanti, numeri non finiti, non interi e modalità sconosciute falliscono con invalid_input e non vengono addebitati. Un page_count pari a zero è rifiutato esplicitamente con un messaggio chiaro che richiede un conteggio positivo: i documenti vuoti non hanno mappa dei fogli. In caso di successo il corpo ripete page_count e il duplex_mode normalizzato, riporta sheet_count e blank_back_last, elenca pages come oggetti con page, sheet, side (front o back) e orientation (upright o rotated_180), elenca sheets con sheet e front_page più back_page e back_orientation opzionali quando esiste un retro, e include un summary breve per log e interfaccia. Esempio: cinque pagine in modalità long_edge producono tre fogli, pagine da uno a cinque mappate fronte-retro-fronte-retro-fronte, blank_back_last true e ogni orientamento upright. Le stesse cinque pagine in short_edge mantengono lo stesso accoppiamento di fogli ma segnano le pagine due e quattro come rotated_180. Abbini la risposta ai Suoi strumenti N-up o di imposizione libretto se le serve un'imposizione oltre il semplice abbinamento duplex; questo endpoint risponde solo all'ordine foglio-lato del duplex standard.

Dove un'API di ordine pagine in fronte-retro conviene

Team di accessibilità e finitura che ribaltano pile finite per controlli di legatura possono mostrare quali pagine appariranno invertite in modalità short-edge prima di caricare il cassetto. Poiché l'implementazione è parse puro di livello A, ogni chiamata riuscita costa il prezzo base pubblicato senza token di modello né rete in uscita; la validazione fallita non consuma saldo. Sale stampa e servizi di stampa gestita usano un controllo dell'ordine pagine in fronte-retro prima di rilasciare lavori di centinaia di pagine così gli operatori possono confermare le scorte (sheet_count) e se l'ultimo foglio richiede un retro bianco. L'automazione d'ufficio che stampa fatture o plichi fronte-retro può affermare blank_back_last e l'orientamento nei test invece di affidarsi a un campione fisico ogni volta che cambia un preset del driver. Gli autori di pipeline PDF che espongono interruttori long-edge contro short-edge in un'interfaccia possono anteprima la mappa dei fogli gratis nel browser, poi chiamare lo stesso contratto da un worker a $0.002 per richiesta riuscita quando il lavoro è in coda.