ForHosting KIT · PDF e documentos

Gire páginas de PDF em 90, 180 ou 270 graus

Girar páginas de PDF corrige documentos com folhas de lado ou de cabeça para baixo sem alterar todas as páginas.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Forneça um PDF clássico, indique as páginas com uma seleção iniciada em 1, como 2,4-6, e escolha um ângulo horário de 90, 180 ou 270 graus. O resultado é um PDF reconstruído cuja rotação se aplica somente às páginas selecionadas. O processamento é determinístico e local à solicitação, sem rede, valores aleatórios, carimbos de data e hora ou retenção de arquivos.

Escolha exatamente quais páginas devem girar

Comece identificando as páginas cuja orientação está errada na ordem atual do documento. A seleção usa numeração iniciada em 1: a primeira página visível é 1, a segunda é 2 e assim por diante. Você pode indicar páginas individuais separadas por vírgulas, escrever um intervalo inclusivo com hífen ou combinar as duas formas. Por exemplo, 1,3-5 gira a primeira, a terceira, a quarta e a quinta páginas, mantendo a página 2 inalterada. Números repetidos são aceitos, mas processados apenas uma vez, o que mantém o resultado previsível. Os intervalos devem ser crescentes, e todo número selecionado precisa existir no PDF. Se o documento tiver seis páginas, uma seleção que termine em 7 será rejeitada em vez de ser reduzida silenciosamente. Esse comportamento rigoroso ajuda em fluxos automatizados, pois uma seleção desatualizada não pode produzir por engano um documento corrigido apenas em parte. Confira a quantidade de páginas antes de enviar uma seleção salva para um relatório, digitalização, lote de faturas ou apresentação recém-gerados.

Selecione o ângulo horário correto

O ângulo descreve o giro horário aplicado a cada página selecionada. Escolha 90 quando o conteúdo apoiado no lado esquerdo precisar de um quarto de volta, 180 quando estiver de cabeça para baixo ou 270 quando precisar de um quarto de volta no sentido oposto. Somente esses valores são aceitos. Um ângulo de 0 não faria nenhum trabalho útil, enquanto ângulos arbitrários, como 45 graus, exigiriam mudar a geometria da página e poderiam cortar o conteúdo; por isso, são rejeitados como entrada inválida. A rotação existente é respeitada, não substituída. Se uma página já tiver rotação de 90 graus e você solicitar mais 90 graus, a rotação resultante será 180 graus. O cálculo retorna ao início depois de uma volta completa. Isso torna operações repetidas fáceis de entender e permite corrigir arquivos com orientações variadas sem adivinhar se uma ferramenta anterior gravou metadados de rotação. A saída também informa o ângulo aplicado e os números das páginas selecionadas.

Entenda a estrutura de PDF compatível e a saída

Esta capacidade lê arquivos PDF clássicos cujas páginas são representadas como objetos de página indiretos comuns e reconstrói uma tabela válida de referências cruzadas. Ela preserva o corpo de cada objeto indireto, altera apenas a entrada de rotação dos dicionários das páginas selecionadas e grava os objetos em ordem numérica estável. Assim, entradas idênticas produzem saídas idênticas, o que ajuda em testes, cache e trilhas de auditoria. PDFs que armazenam a estrutura em fluxos de objetos compactados ou fluxos de referências cruzadas são rejeitados com um erro claro, em vez de serem regravados de forma incompleta. Se o documento de origem usar essa estrutura mais recente, salve ou exporte como PDF clássico antes de girá-lo aqui. O objeto retornado contém o texto PDF reconstruído, os números das páginas selecionadas a partir de 1 e o ângulo aceito. A transformação não usa rede, modelo, carimbo de data e hora ou identificador aleatório. O navegador atende correções interativas, e chamadas de API custam US$ 0,002 por solicitação.

Casos de uso

Corrija digitalizações com orientações variadas

Gire somente as folhas que entraram de lado no scanner e preserve as páginas que já estavam na orientação correta.

Repare relatórios montados

Corrija anexos em paisagem ou inserções invertidas depois que vários documentos de origem forem combinados.

Automatize a entrada de documentos

Aplique uma regra conhecida de seleção a pacotes PDF recorrentes e registre quais páginas foram alteradas.

Perguntas frequentes

Quais ângulos de rotação são aceitos?

Somente giros horários de 90, 180 e 270 graus são aceitos. Qualquer outro valor gera um erro de entrada inválida.

Como selecionar várias páginas?

Use números iniciados em 1 separados por vírgulas, intervalos inclusivos como 3-5 ou uma combinação como 1,3-5.

O que acontece com as páginas não selecionadas?

Os dicionários dessas páginas permanecem inalterados. Apenas os objetos selecionados recebem uma entrada de rotação atualizada.

A ferramenta preserva uma rotação existente?

Sim. O ângulo solicitado é somado à rotação existente, e o resultado é normalizado dentro de uma volta completa.

Por que a estrutura do meu PDF foi rejeitada?

O analisador determinístico aceita objetos indiretos clássicos e tabelas de referências cruzadas, não fluxos compactados de objetos ou referências.

Quanto custa uma solicitação de API?

Cada solicitação de API custa US$ 0,002. A execução interativa no navegador está disponível sem chamada de rede.

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

POSThttps://api.kit.forhosting.com/pdf/rotate-pages

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/rotate-pages \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf":"https://ejemplo.com/documento.pdf","pages":"2","angle":90}'

const res = await fetch("https://api.kit.forhosting.com/pdf/rotate-pages", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf",
    "pages": "2",
    "angle": 90
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/rotate-pages",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf",
    "pages": "2",
    "angle": 90
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/rotate-pages", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pdf":"https://ejemplo.com/documento.pdf","pages":"2","angle":90}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf","pages":"2","angle":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/rotate-pages", 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

{
  "pdf": "https://ejemplo.com/documento.pdf",
  "pages": "2",
  "angle": 90
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.rotate_pages",
  "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

por chamadaUS$ 0,002

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.

Ver a documentação completa do KIT →