Orden páginas PDF dúplex

Un recuento cero se rechaza con invalid_input.

Qué significan el dúplex de borde largo y de borde corto para el orden de páginas

Cuando el recuento es impar, la hoja final tiene anverso impreso y reverso en blanco: el comprobador lo indica con blank_back_last en true y omite back_page en el objeto de esa hoja en lugar de inventar una página fantasma. El modo long_edge (también aceptado con alias estilo libro) marca todas las caras upright: voltee la hoja por su borde largo y el reverso se lee bien sin girar el papel ciento ochenta grados. El modo short_edge (alias estilo calendario) marca cada reverso como rotated_180: voltee por el borde corto y el contenido del reverso queda invertido respecto al anverso si sostiene la pila sin ese volteo.

Contrato de entrada, forma de la respuesta y comportamiento de error

Los recuentos negativos también se rechazan. Combine la respuesta con sus propias herramientas N-up o de imposición de cuadernillo si necesita más que el emparejamiento dúplex simple; este extremo solo responde el orden hoja-cara del dúplex estándar. Envíe un cuerpo JSON con dos campos obligatorios. page_count es un entero no negativo (alias pages, n, count); debe ser un número entero porque no se puede imprimir una fracción de página. duplex_mode es una cadena normalizada a long_edge o short_edge (alias mode, flip, binding). Las grafías aceptadas de borde largo incluyen long_edge, long-edge, longedge, flip_long, long y book; las de borde corto incluyen short_edge, short-edge, shortedge, flip_short, short y calendar. Campos ausentes, números no finitos, no enteros y modos desconocidos fallan con invalid_input y no se facturan. Un page_count de cero se rechaza de forma explícita con un mensaje claro de que se exige un recuento positivo: los documentos vacíos no tienen mapa de hojas. En caso de éxito el cuerpo repite page_count y el duplex_mode normalizado, informa sheet_count y blank_back_last, enumera pages como objetos con page, sheet, side (front o back) y orientation (upright o rotated_180), enumera sheets con sheet y front_page más back_page y back_orientation opcionales cuando hay reverso, e incluye un summary breve para registros e interfaz. Ejemplo: cinco páginas en modo long_edge dan tres hojas, páginas del uno al cinco mapeadas anverso-reverso-anverso-reverso-anverso, blank_back_last true y toda orientación upright. Las mismas cinco páginas en short_edge mantienen el emparejamiento de hojas pero marcan las páginas dos y cuatro como rotated_180.

Dónde una API de orden de páginas en dúplex aporta valor

Los equipos de accesibilidad y acabado que voltean pilas terminadas para comprobar el encuadernado pueden mostrar qué páginas saldrán invertidas en modo short-edge antes de cargar la bandeja. Como la implementación es parse puro de nivel A, cada llamada correcta cuesta el precio base publicado sin tokens de modelo ni red de salida; la validación fallida no consume saldo. Las salas de impresión y los servicios de impresión gestionada usan un comprobador de orden de páginas en dúplex antes de liberar trabajos de cientos de páginas para que los operadores confirmen el stock (sheet_count) y si la última hoja necesita un reverso en blanco. La automatización de oficina que imprime facturas o paquetes a doble cara puede afirmar blank_back_last y la orientación en pruebas en lugar de depender de una muestra física cada vez que cambia un preset del controlador. Los autores de tuberías PDF que exponen conmutadores long-edge frente a short-edge en una interfaz pueden previsualizar el mapa de hojas gratis en el navegador y luego llamar al mismo contrato desde un worker a $0.002 por solicitud correcta cuando se encola el trabajo.