ForHosting KIT · PDF e documentos

Remova páginas PDF em branco e conte as restantes

Remova páginas PDF vazias de um fluxo documental sem adivinhar quais números devem desaparecer.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Envie um registro para cada página, na ordem, e informe se ela contém texto ou imagens. A capacidade considera uma página vazia somente quando os dois sinais estão ausentes, retorna os números a partir de um e calcula quantas páginas restam após a remoção. É útil depois de digitalizar, montar ou exportar documentos quando outra etapa já detectou o conteúdo.

Descreva cada página na ordem original

Comece pelo inventário criado por seu analisador, scanner ou fluxo documental. Envie uma lista pages com um registro por página e preserve a ordem exata. Cada registro exige dois booleanos: has_text informa se existe texto e has_images se existem imagens. Use true ou false, nunca textos ou números. A posição define o número: o primeiro registro representa a página 1. Inclua todas as páginas para não deslocar a numeração posterior.

Entenda o que é considerado vazio

Uma página só é vazia quando has_text e has_images são false. Texto ou imagem é suficiente para mantê-la. Essa regra conservadora protege digitalizações, assinaturas, diagramas e capas. A capacidade não avalia espaço visual, OCR, anotações ou desenhos; seus indicadores são a fonte de verdade. A resposta usa números a partir de um e traz as contagens original, removida e restante. Se todas forem vazias, restam zero; se nenhuma for, a lista fica vazia.

Aplique o resultado com segurança

Use blank_pages como plano de exclusão na biblioteca que controla o PDF real. Como muitos programas alteram índices após cada remoção, exclua em ordem decrescente ou forneça toda a seleção original de uma vez. Consulte remaining_page_count se seu sistema precisar impedir um documento sem páginas. As contagens também ajudam em prévias e auditorias. O cálculo é determinístico, não usa rede nem OCR e custa US$ 0,002 por chamada de API.

Casos de uso

Limpe lotes digitalizados

Transforme sinais de conteúdo do scanner em uma lista de exclusão antes de arquivar cada PDF.

Remova separadores de exportação

Encontre páginas vazias inseridas ao juntar relatórios e calcule o total final antes da entrega.

Visualize a limpeza

Mostre quais páginas serão removidas e quantas restarão antes de alterar o arquivo.

Perguntas frequentes

Quanto custa?

Uma chamada de API custa US$ 0,002. O mesmo cálculo determinístico também está disponível no navegador.

Quando uma página é vazia?

Somente quando has_text e has_images são false. Se qualquer um for true, a página permanece.

Os números começam em zero?

Não. Eles começam em um, portanto o primeiro registro é a página 1.

A capacidade edita ou devolve um PDF?

Não. Ela retorna um plano e contagens; sua biblioteca de PDF executa as remoções.

O que ocorre se todas forem vazias?

Todas são listadas e remaining_page_count é zero. Sua aplicação decide se aceita o resultado.

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/remove-blank-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/remove-blank-pages \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pages":[{"has_text":true,"has_images":false},{"has_text":false,"has_images":false},{"has_text":false,"has_images":true}]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/remove-blank-pages", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pages": [
      {
        "has_text": true,
        "has_images": false
      },
      {
        "has_text": false,
        "has_images": false
      },
      {
        "has_text": false,
        "has_images": true
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/remove-blank-pages",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pages": [
        {
            "has_text": true,
            "has_images": false
        },
        {
            "has_text": false,
            "has_images": false
        },
        {
            "has_text": false,
            "has_images": true
        }
    ]
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"pages":[{"has_text":true,"has_images":false},{"has_text":false,"has_images":false},{"has_text":false,"has_images":true}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/remove-blank-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

{
  "pages": [
    {
      "has_text": true,
      "has_images": false
    },
    {
      "has_text": false,
      "has_images": false
    },
    {
      "has_text": false,
      "has_images": true
    }
  ]
}

Exemplo de resposta

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