PDF両面印刷のページ順

ページ数ゼロは invalid_input で拒否されます。

長辺・短辺両面がページ順に意味すること

ページ数が奇数のとき最終用紙は印刷された表面と空白の裏面を持ち、チェッカーは blank_back_last を true とし、幽霊ページを作らずその用紙オブジェクトで back_page を省略します。long_edge モード（本綴じ風の別名も可）はすべての面を upright とし、長辺で返すと裏面は紙を180度回さずに正しく読めます。short_edge モード（カレンダー風の別名）は各裏面を rotated_180 とし、短辺で返し、そのめくりなしで束を持つと裏面は表面に対して逆さまになります。

入力契約、応答形状、エラーの扱い

空の文書には用紙マップがありません。単純な両面对以外の面付けが必要なら独自のNアップや小冊子ツールと組み合わせてください。必須フィールド2つのJSON本文をPOSTしてください。page_count は非負の整数（別名 pages、n、count）で、端数ページは印刷できないため整数である必要があります。duplex_mode は long_edge または short_edge に正規化される文字列（別名 mode、flip、binding）です。長辺の表記には long_edge、long-edge、longedge、flip_long、long、book があり、短辺には short_edge、short-edge、shortedge、flip_short、short、calendar があります。欠落フィールド、非有限数、非整数、未知のモード文字列は invalid_input で失敗し課金されません。page_count がゼロの場合は正のページ数が必要である旨を明示して拒否します。負の数も拒否されます。 成功時は page_count と正規化済み duplex_mode を返し、sheet_count と blank_back_last を報告し、page・sheet・side（front または back）・orientation（upright または rotated_180）を持つ pages、sheet と front_page、裏面がある場合の back_page と back_orientation を持つ sheets、およびログやUI向けの短い summary を含めます。例：long_edge で5ページは3枚の用紙、1から5が表裏表裏表、blank_back_last true、すべて upright です。同じ5ページを short_edge にすると用紙の組は同じでページ2と4が rotated_180 になります。本エンドポイントは標準両面の用紙・面順のみを答えます。

両面ページ順APIが役立つ場面

実装は純粋な parse ティアAのため、成功呼び出しは公開基本料金のみでモデルトークンも外部通信もなく、検証失敗は残高を消費しません。印刷室やマネージド印刷は、数百ページのジョブを出す前に両面ページ順チェッカーで在庫（sheet_count）と最終用紙の空白裏面の要否を確認します。請求書や束を両面印刷する事務自動化は、ドライバプリセットが変わるたびに現物サンプルに頼る代わりに、テストで blank_back_last と向きを検証できます。UIに長辺／短辺切替を出すPDFパイプライン作者は、ブラウザで無料に用紙マップをプレビューし、ジョブ投入時にワーカーから同一契約を成功1回あたり$0.002で呼び出せます。製本確認で仕上がり束をめくるアクセシビリティや仕上げチームは、トレイに積む前に short_edge で反転するページを示せます。