Ordre pages PDF recto verso

Un décompte nul est rejeté avec invalid_input.

Ce que le recto verso bord long et bord court signifient pour l'ordre des pages

Lorsque le décompte est impair, la dernière feuille a un recto imprimé et un verso blanc : le vérificateur l'indique avec blank_back_last à true et omet back_page sur l'objet de cette feuille au lieu d'inventer une page fantôme. Le mode long_edge (également accepté avec des alias style livre) marque toutes les faces upright : retournez la feuille sur son bord long et le verso se lit correctement sans tourner le papier de cent quatre-vingts degrés. Le mode short_edge (alias style calendrier) marque chaque verso comme rotated_180 : retournez sur le bord court et le contenu du verso est à l'envers par rapport au recto si vous tenez la pile sans ce retournement.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Les décomptes négatifs sont aussi rejetés. Associez la réponse à vos propres outils N-up ou d'imposition de livret si vous avez besoin d'une imposition au-delà du simple appariement duplex ; ce point de terminaison ne répond qu'à l'ordre feuille-face du duplex standard. Envoyez un corps JSON avec deux champs obligatoires. page_count est un entier non négatif (alias pages, n, count) ; ce doit être un nombre entier car on n'imprime pas une fraction de page. duplex_mode est une chaîne normalisée en long_edge ou short_edge (alias mode, flip, binding). Les orthographes acceptées pour bord long incluent long_edge, long-edge, longedge, flip_long, long et book ; pour bord court : short_edge, short-edge, shortedge, flip_short, short et calendar. Champs manquants, nombres non finis, non entiers et modes inconnus échouent avec invalid_input et ne sont pas facturés. Un page_count de zéro est rejeté explicitement avec un message clair exigeant un décompte positif : les documents vides n'ont pas de carte de feuilles. En cas de succès le corps renvoie page_count et le duplex_mode normalisé, indique sheet_count et blank_back_last, liste pages comme objets avec page, sheet, side (front ou back) et orientation (upright ou rotated_180), liste sheets avec sheet et front_page plus back_page et back_orientation optionnels lorsqu'un verso existe, et inclut un summary court pour les journaux et l'interface. Exemple : cinq pages en mode long_edge donnent trois feuilles, pages un à cinq mappées recto-verso-recto-verso-recto, blank_back_last true et toute orientation upright. Les mêmes cinq pages en short_edge gardent le même appariement de feuilles mais marquent les pages deux et quatre comme rotated_180.

Où une API d'ordre des pages en recto verso apporte de la valeur

Les équipes d'accessibilité et de finition qui retournent des piles terminées pour vérifier la reliure peuvent montrer quelles pages apparaîtront inversées en mode short-edge avant de charger le bac. Comme l'implémentation est un parse pur de niveau A, chaque appel réussi coûte le prix de base publié sans jetons de modèle ni réseau sortant ; une validation échouée ne consomme pas le solde. Les salles d'impression et les services d'impression gérés utilisent un vérificateur d'ordre des pages en recto verso avant de libérer des travaux de plusieurs centaines de pages afin que les opérateurs confirment le stock (sheet_count) et si la dernière feuille a besoin d'un verso blanc. L'automatisation de bureau qui imprime factures ou liasses en double face peut affirmer blank_back_last et l'orientation dans les tests au lieu de dépendre d'un échantillon physique à chaque changement de préréglage du pilote. Les auteurs de pipelines PDF qui exposent des bascules long-edge versus short-edge dans une interface peuvent prévisualiser la carte des feuilles gratuitement dans le navigateur, puis appeler le même contrat depuis un worker à $0.002 par requête réussie lorsque le travail est mis en file.