ForHosting KIT · PDF e documentos

Insira uma página em branco em qualquer posição do PDF

Insira uma página em branco em um PDF existente sem reconstruir o documento manualmente.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Envie o PDF e uma posição contada a partir de 1; a ferramenta colocará ali uma página limpa com as mesmas dimensões da página localizada naquele ponto. Para adicionar ao final, use a posição imediatamente posterior à última página atual. A operação é determinística, mantém a ordem original e rejeita claramente posições inexistentes.

Escolha a posição exata de inserção

As posições começam em 1 porque indicam onde a nova página aparecerá para quem ler o documento pronto. A posição 1 insere uma folha em branco antes da primeira página atual. A posição 2 a coloca entre a primeira e a segunda. Em um documento com cinco páginas, a posição 6 acrescenta uma folha depois da quinta. Essas são as únicas posições válidas: o mínimo é 1 e o máximo corresponde ao total atual mais um. Essa regra explícita impede que uma solicitação ambígua produza silenciosamente um documento com a folha no lugar errado. Se a posição for zero, negativa, fracionária ou maior que a posição final, a solicitação retornará um erro de entrada inválida e manterá a origem intacta. Antes de automatizar um fluxo, conte as páginas e calcule a posição com base no documento realmente enviado. O resultado informa a posição inserida e o novo total, permitindo que você confira a transformação.

Como a página em branco recebe seu tamanho

A página inserida usa a caixa de mídia efetiva da página que ocupa a posição solicitada. Portanto, inserir antes de uma folha carta em orientação retrato cria uma folha vazia com o mesmo formato; se a próxima página for paisagem ou personalizada, essas dimensões serão preservadas. Ao acrescentar no final, não há uma página seguinte para consultar, então a nova folha copia o tamanho da última página existente. Isso é útil em PDFs com formatos mistos, como prontuários digitalizados, materiais de apresentação, projetos e relatórios reunidos. A folha fica intencionalmente vazia: não possui fluxo de conteúdo, anotações, campos de formulário nem marcas copiadas. Somente a geometria é mantida. A resposta também mostra a largura e a altura calculadas em pontos PDF, para que você confirme as dimensões escolhidas. As páginas de origem preservam sua ordem e seu conteúdo.

Prepare uma entrada compatível e confira o resultado

Forneça um PDF clássico como texto PDF simples ou como URI de dados PDF em base64. Esta versão beta rejeita deliberadamente documentos com fluxo de referências cruzadas, em vez de tentar reconstruir estruturas sem segurança. O analisador lê o catálogo e a árvore de páginas, percorre nós aninhados, resolve caixas de mídia herdadas, insere a nova referência no pai correto, atualiza as contagens afetadas e reconstrói uma tabela clássica válida. Nenhuma rede, relógio, aleatoriedade, camada de armazenamento ou modelo participa do processo. Depois, confira a contagem de páginas, a posição, a largura e a altura retornadas; então salve ou encaminhe o PDF. Em automações, teste primeiro arquivos representativos. Se um fluxo de referências cruzadas for rejeitado, converta o arquivo para PDF clássico com uma ferramenta confiável. Cada solicitação à API custa US$ 0,002; a mesma operação determinística também pode ser usada interativamente no navegador.

Casos de uso

Adicionar uma folha separadora

Insira uma página limpa entre seções de um relatório combinado para dividir ou anotar as cópias impressas.

Restaurar o alinhamento frente e verso

Acrescente uma folha vazia onde necessário para que um capítulo ou formulário comece no lado correto da impressão duplex.

Criar espaço para assinaturas ou notas

Coloque uma folha vazia do mesmo tamanho junto ao material de apoio sem recriar nem redimensionar o PDF original.

Perguntas frequentes

Quais posições são válidas?

Use um inteiro de 1 até o total atual de páginas mais um. O último valor acrescenta a folha ao final.

Qual tamanho de página é usado?

A folha copia a caixa de mídia efetiva da página na posição indicada ou da última página quando for acrescentada ao final.

A nova página contém alguma coisa?

Não. Ela tem as dimensões escolhidas, mas não contém conteúdo, anotações, campos de formulário nem elementos gráficos copiados.

O que acontece se a posição estiver fora do intervalo?

A solicitação retorna um erro de entrada inválida e não produz um PDF modificado.

Quanto custa uma solicitação à API?

Cada solicitação custa US$ 0,002.

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/insert-blank-page

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

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

import os, requests

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

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/insert-blank-page", 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","position":2}',
  ],
]));
$task = json_decode($res, true);

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

Exemplo de resposta

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