Ordem páginas PDF duplex
Cinco páginas pela borda longa ocupam três folhas, com todos os lados na posição normal e o verso da última em branco. Informe as páginas e o modo de virada e receba o mapa das folhas antes de abastecer a bandeja. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Quantidade de páginas
- 5
- Modo duplex
- long_edge
- Número de folhas
- 3
A impressão duplex coloca duas páginas PDF em uma folha física, mas o eixo de virada muda a orientação do verso ao reler a pilha. A virada pela borda longa é o acabamento tipo livro em documentos retrato: você gira a folha da esquerda para a direita e o verso permanece direito. A virada pela borda curta é o estilo calendário ou bloco de notas: vira de cima para baixo e o verso aparece rotacionado cento e oitenta graus em relação à frente. Gráficas, escritórios e scripts de automação precisam de um mapa de folhas determinístico antes de carregar a bandeja ou configurar o driver, não de um chute após estragar o papel. Este verificador de ordem de páginas PDF em duplex aceita uma contagem positiva de páginas e um modo duplex, devolve o número da folha, a face e a orientação de cada página, lista cada folha física com frente e verso opcional, e sinaliza quando a última folha tem o verso em branco porque a contagem é ímpar.
O que duplex de borda longa e de borda curta significam para a ordem das páginas
Um trabalho duplex sempre emparelha páginas em folhas na ordem de leitura: a folha um leva a página um na frente e a página dois no verso quando existem duas páginas; a folha dois leva as páginas três e quatro; e assim por diante até atribuir todas. A contagem de folhas é o teto da contagem de páginas dividido por dois. O modo duplex não altera qual número de página lógica ocupa cada face da folha; altera como o verso se orienta para o acabamento e a reinserção manual.
Drivers e acabamentos que oferecem virada por borda longa versus borda curta implementam a mesma ideia física. Conhecer o mapa com antecedência evita a falha clássica em que os ímpares saem bem e os pares saem invertidos ou na ordem de leitura errada depois de virar a pilha. Use o array pages para ferramentas por página e o array sheets quando importar estoque físico, capacidade da bandeja ou versos em branco.
Casos de uso
Pré-visualizações de driver e interface
Mostre aos usuários qual página cai em cada face — e se os versos giram na virada de borda curta — ao alternar entre duplex de borda longa e de borda curta.
CI para pipelines de impressão
Afirme mapeamentos estáveis folha-face em testes automatizados sempre que presets duplex ou contagens de páginas mudarem em um fluxo documental.
Perguntas frequentes
O que acontece se a contagem de páginas for zero?
Um documento com zero páginas não tem mapa de folhas; informe uma contagem positiva. Validação falha não é cobrada.
Qual a diferença entre virar pela borda longa e pela curta?
Pela borda longa a folha vira da esquerda para a direita, como um livro, e o verso fica na posição normal. Pela borda curta ela vira de cima para baixo, como um calendário, e o verso aparece girado 180 graus em relação à frente.
O modo de virada muda qual página fica em cada lado?
Não. As páginas sempre são pareadas na ordem de leitura: a 1 na frente da primeira folha, a 2 no verso, e assim por diante. O modo só muda a orientação do verso.
O que acontece com um número ímpar de páginas?
A última folha tem a frente impressa e o verso em branco, e o resultado avisa isso em vez de inventar uma página extra. Cinco páginas, por exemplo, ocupam três folhas, e a terceira fica sem verso impresso.
Por que as páginas pares saem de cabeça para baixo?
Porque o eixo de virada não combina com o jeito de virar a pilha. Na virada pela borda curta cada verso sai girado 180 graus; o mapa mostra essa orientação antes da impressão, não depois de perder uma resma.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/pdf/duplex-page-order-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"page_count":5,"duplex_mode":"long_edge"}'const res = await fetch("https://api.kit.forhosting.com/pdf/duplex-page-order-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"page_count": 5,
"duplex_mode": "long_edge"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/duplex-page-order-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"page_count": 5,
"duplex_mode": "long_edge"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/duplex-page-order-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"page_count":5,"duplex_mode":"long_edge"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"page_count":5,"duplex_mode":"long_edge"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/duplex-page-order-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"page_count": 5,
"duplex_mode": "long_edge"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.duplex_page_order_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_mb | 25 |
max_pages | 200 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Contagem zero é rejeitada com invalid_input.
O que duplex de borda longa e de borda curta significam para a ordem das páginas
Quando a contagem é ímpar, a folha final tem frente impressa e verso em branco: o verificador reporta isso com blank_back_last true e omite back_page no objeto dessa folha em vez de inventar uma página fantasma. O modo long_edge (também aceito com aliases estilo livro) marca todas as faces upright: vire a folha pela borda longa e o verso lê-se corretamente sem girar o papel cento e oitenta graus. O modo short_edge (aliases estilo calendário) marca cada verso como rotated_180: vire pela borda curta e o conteúdo do verso fica de cabeça para baixo em relação à frente se você segurar a pilha sem essa virada.
Contrato de entrada, forma da resposta e comportamento de erro
Contagens negativas também são rejeitadas. Envie um corpo JSON com dois campos obrigatórios. page_count é um inteiro não negativo (aliases pages, n, count); deve ser um número inteiro porque não se imprime fração de página. duplex_mode é uma string normalizada para long_edge ou short_edge (aliases mode, flip, binding). Grafias aceitas de borda longa incluem long_edge, long-edge, longedge, flip_long, long e book; as de borda curta incluem short_edge, short-edge, shortedge, flip_short, short e calendar. Campos ausentes, números não finitos, não inteiros e modos desconhecidos falham com invalid_input e não são cobrados. Um page_count zero é rejeitado de forma explícita com mensagem clara de que é preciso contagem positiva: documentos vazios não têm mapa de folhas. Em caso de sucesso o corpo ecoa page_count e o duplex_mode normalizado, informa sheet_count e blank_back_last, lista pages como objetos com page, sheet, side (front ou back) e orientation (upright ou rotated_180), lista sheets com sheet e front_page mais back_page e back_orientation opcionais quando há verso, e inclui um summary curto para logs e interface. Exemplo: cinco páginas em modo long_edge geram três folhas, páginas de um a cinco mapeadas frente-verso-frente-verso-frente, blank_back_last true e toda orientação upright. As mesmas cinco páginas em short_edge mantêm o emparelhamento de folhas mas marcam as páginas dois e quatro como rotated_180. Combine a resposta com suas próprias ferramentas N-up ou de imposição de livreto se precisar de mais do que o emparelhamento duplex simples; este endpoint só responde a ordem folha-face do duplex padrão.
Onde uma API de ordem de páginas em duplex agrega valor
Equipes de acessibilidade e acabamento que viram pilhas prontas para checar o acabamento podem mostrar quais páginas aparecerão invertidas no modo short-edge antes de carregar a bandeja. Como a implementação é parse puro de nível A, cada chamada bem-sucedida custa o preço base publicado sem tokens de modelo nem rede de saída; validação falha não consome saldo. Salas de impressão e serviços gerenciados usam um verificador de ordem de páginas em duplex antes de liberar trabalhos de centenas de páginas para que operadores confirmem o estoque (sheet_count) e se a última folha precisa de verso em branco. Automação de escritório que imprime faturas ou pacotes frente e verso pode afirmar blank_back_last e a orientação em testes em vez de depender de amostra física toda vez que um preset do driver muda. Autores de pipelines PDF que expõem chaves long-edge versus short-edge em uma interface podem pré-visualizar o mapa de folhas de graça no navegador e depois chamar o mesmo contrato de um worker a US$ 0,002 por solicitação bem-sucedida quando o trabalho é enfileirado.
Casos de integração
Planejamento de folhas na pré-impressão
Converta a contagem de páginas de um PDF e o modo de virada escolhido em sheet_count, pares frente/verso e flags de verso em branco antes de carregar o papel ou configurar o driver.
Perguntas técnicas
Como verifico a ordem de páginas de impressão duplex de um PDF?
Envie page_count (inteiro positivo) e duplex_mode (long_edge ou short_edge). A API devolve folha, face e orientação de cada página, além de um mapa frente/verso por folha.
Qual é a diferença entre borda longa e borda curta?
Ambos os modos emparelham páginas da mesma forma (1–2 na folha 1, 3–4 na 2, …). long_edge mantém versos upright; short_edge marca versos rotated_180 (virada estilo calendário).
E se o meu PDF tiver um número ímpar de páginas?
sheet_count continua sendo ceil(page_count/2). A última folha tem só a frente; blank_back_last é true e back_page é omitido nessa folha.
Quanto custa o verificador de ordem de páginas em duplex?
A ferramenta do navegador é gratuita. Solicitações de API usam saldo KIT pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.