ForHosting KIT · PDF e documentos

Liste marcadores de PDF com páginas e níveis

Transforme a árvore de tópicos de um PDF em uma lista de marcadores limpa e ordenada, fácil de inspecionar, testar, exportar ou integrar a outro fluxo.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Cada item retornado contém o título, o nível de hierarquia iniciado em um e a página de destino também iniciada em um. O percurso preserva a ordem original e posiciona cada item filho logo depois do pai. Árvores vazias são rejeitadas de forma explícita, para que a ausência de um sumário não seja confundida com um resultado bem-sucedido sem dados.

Converta uma árvore aninhada em linhas úteis

Os marcadores de PDF normalmente formam uma árvore de tópicos. Capítulos ficam no primeiro nível, seções aparecem abaixo deles e subtítulos podem avançar por vários níveis. Essa organização é ótima no leitor de PDF, mas pouco prática para auditar a navegação, criar um relatório, comparar edições ou enviar dados a uma planilha. Esta capacidade percorre a árvore em pré-ordem: apresenta o pai, depois todos os descendentes na sequência original e só então passa ao próximo irmão. Cada linha reúne o necessário para um inventário: título, nível e página de destino. Níveis e páginas começam em um. A lista final mantém a ordem de leitura visível, mas elimina o aninhamento recursivo. A ferramenta não abre nem altera um arquivo PDF; ela recebe a árvore já extraída por um analisador ou por uma etapa anterior do processamento documental.

Entenda a validação e a ordem determinística

Cada marcador deve ser um objeto com título não vazio e página representada por um número inteiro positivo. A coleção opcional de filhos precisa ser um array de outros marcadores. Espaços nas extremidades do título são removidos, enquanto o texto interno permanece intacto. O algoritmo não ordena por nome nem por página, pois isso poderia apagar a intenção do autor. Ele segue a sequência recebida e calcula o nível conforme a profundidade. Assim, a mesma entrada sempre gera a mesma saída, sem rede, horários, identificadores aleatórios ou dependência do ambiente. Uma árvore superior vazia causa erro de entrada inválida. Isso permite que uma automação pare quando o documento não tem marcadores, em vez de publicar um índice vazio aparentemente correto. Filhos malformados, títulos ausentes, páginas inválidas, profundidade excessiva, ciclos e árvores grandes demais também são recusados com mensagens claras.

Aplique a lista em fluxos de documentos

Uma lista plana de marcadores cria uma interface simples entre a análise do PDF e as próximas regras do processo. Você pode apresentá-la como sumário, confirmar a presença de todos os capítulos, comparar títulos e destinos entre versões ou associar páginas a seções para extração posterior. A resposta inclui a contagem total e os registros em ordem, permitindo verificar a quantidade antes de tratar cada item. O nível ajuda a reconstruir recuos ou até a árvore, enquanto a página apoia navegação e cálculo de intervalos. A capacidade apenas relata a árvore recebida: ela não confirma se as páginas existem no arquivo original, não deduz títulos a partir do conteúdo e não corrige destinos quebrados. Quando o analisador fornecer o total de páginas, faça essa validação no seu fluxo. A execução interativa é gratuita no navegador, e cada chamada automatizada via API custa US$ 0,002; os dois canais compartilham a mesma lógica determinística.

Casos de uso

Audite a navegação do documento

Examine todos os marcadores na ordem visível e identifique capítulos ausentes, hierarquia inesperada ou destinos incorretos antes da publicação.

Monte um sumário

Converta a saída do analisador em linhas que podem receber recuo por nível e links para as páginas de destino.

Compare edições de PDF

Crie inventários estáveis de duas versões e compare títulos, hierarquia, sequência e páginas de destino.

Perguntas frequentes

Esta capacidade lê o arquivo PDF diretamente?

Não. Ela recebe uma árvore produzida por um analisador de PDF e transforma essa estrutura em registros de marcadores.

Qual ordem aparece no resultado?

É usada a pré-ordem: cada pai vem antes dos filhos, e os irmãos permanecem na sequência documental fornecida.

Como os níveis são numerados?

Marcadores superiores recebem nível 1, seus filhos recebem nível 2 e cada camada adicional aumenta o nível em um.

O que acontece com uma árvore vazia?

A solicitação falha com erro de entrada inválida, evitando confundir a ausência de marcadores com um relatório vazio válido.

A ferramenta verifica se as páginas existem?

Ela exige destinos inteiros positivos, mas não consegue compará-los ao total de páginas sem uma verificação separada.

Quanto custa uma solicitação pela API?

Uma solicitação pela API custa US$ 0,002. A mesma lógica determinística também pode ser executada gratuitamente no navegador.

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/bookmarks-list

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/bookmarks-list \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"outline":[{"title":"Introduction","page":1,"children":[{"title":"Background","page":3}]},{"title":"Methods","page":8}]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/bookmarks-list", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "outline": [
      {
        "title": "Introduction",
        "page": 1,
        "children": [
          {
            "title": "Background",
            "page": 3
          }
        ]
      },
      {
        "title": "Methods",
        "page": 8
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/bookmarks-list",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "outline": [
        {
            "title": "Introduction",
            "page": 1,
            "children": [
                {
                    "title": "Background",
                    "page": 3
                }
            ]
        },
        {
            "title": "Methods",
            "page": 8
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/bookmarks-list", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"outline":[{"title":"Introduction","page":1,"children":[{"title":"Background","page":3}]},{"title":"Methods","page":8}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"outline":[{"title":"Introduction","page":1,"children":[{"title":"Background","page":3}]},{"title":"Methods","page":8}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/bookmarks-list", 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

{
  "outline": [
    {
      "title": "Introduction",
      "page": 1,
      "children": [
        {
          "title": "Background",
          "page": 3
        }
      ]
    },
    {
      "title": "Methods",
      "page": 8
    }
  ]
}

Exemplo de resposta

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