Adicionar número de página ao PDF
Editar → Adicionar número de página ao PDF
O Adicionar número de página ao PDF API adiciona números de página ao seu PDFVocê envia o PDF (docContent, docName), pageNumberFormat (por exemplo # of {1} onde # é a página atual e {1} é o total de páginas), alignX e alignY, margens opcionais, fontSize, isBold, isItalic, skipFirstPage, e async. O API retorna o PDF Com a adição de números de página. Use o testador abaixo para experimentar; mais detalhes estão nas seções seguintes.
Experimente a opção Adicionar número de página. PDF API
:::nota Referência rápida
Ponto final: POST /api/v2/AddPageNumber · Obrigatório: api-key, docContent, docName, pageNumberFormat, alignX, alignY
:::
Use o formulário abaixo para enviar sua API chave, PDF (Base64), formato (ex.: "# de 1"), e posição. A resposta é a PDF Com números de página. Nenhum código é necessário, preencha os campos e clique. Enviar solicitação.
Visão geral, parâmetros e casos de uso
- Overview
- Parameters
- Use cases
O que significa Adicionar Número de Página? PDF?
Este endpoint adiciona números de página a páginas específicas de um arquivo. PDFVocê escolhe o formato com pageNumberFormat: usar # para a página atual e {1} para o número total de páginas. A posição é definida por alignX (esquerda, centro, direita) e alignY (superior, central, inferior), margens opcionais em mm, fontSize (8-72), isBold, isItalic, e skipFirstPage Omitir a numeração na primeira página.
Opções de formato de número de página
- #: Espaço reservado para o número da página atual.
- 1: Espaço reservado para o número total de páginas.
- Exemplos:
"# of {1}"→ "1 de 10", "2 de 10";"Page #"→ "Página 1", "Página 2";"# / {1}"→ "1 / 10";"- # -"→ "- 1 -";"[#/{1}]"→ "[1/10]";"(#)"→ "(1)";"#"→ apenas "1", "2", etc.
Principais características
- Formatar: pageNumberFormat com
#e{1}como acima. - Posição: alignX (esquerda, centro, direita), alignY (superior, médio, inferior), marginXinMM, marginYinMM.
- Estilização: fontSize (8-72), isBold, isItalic.
- skipFirstPage: Omitir o número da página na primeira página (por exemplo, na capa).
Use para relatórios, manuais ou qualquer documento com várias páginas PDF que precisa de paginação. Combine com Adicionar HTML Cabeçalho Rodapé para PDF ou Adicionar margem a PDF para um layout consistente.
API parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| api-key | corda | Sim | Seu PDF4me API chave, Base64 codificado. Obtenha-o do painel. |
| docContent | base64 | Sim | PDF conteúdo do arquivo (Base64). |
| docName | corda | Sim | Saída PDF Nome do arquivo (ex.: output.pdf). |
| pageNumberFormat | corda | Sim | Formatar com # e {1} (ex.: "# de 1", "Página #"). |
| alignX | corda | Sim | esquerda, centro, direita. |
| alignY | corda | Sim | superior, meio, inferior. |
| marginXinMM, marginYinMM | inteiro | Não | Margens a partir da borda em mm (0-100). |
| fontSize | inteiro | Não | 8-72. |
| isBold, isItalic | booleano | Não | Negrito ou itálico. |
| skipFirstPage | booleano | Não | Ignore a numeração da primeira página. |
| async | booleano | Não | Ativar o processamento assíncrono. |
Quando usar Adicionar número de página para PDF
- Relatórios e manuaisAdicione a numeração no estilo "Página 1 de 10" ou "1/10".
- Questões legais e contratosNumere as páginas para referência (por exemplo, "Página #" ou "(#)").
- Pronto para impressão PDFsCertifique-se de que todas as páginas tenham um número de página visível antes da impressão ou distribuição.
Para esquemas de requisição/resposta e exemplos de código, consulte Adicionar número de página ao PDF no PDF4me API documentos.
Pré-requisitos
Antes de usar este endpoint, certifique-se de que você possui:
- Um válido PDF4me API chave (Adquira o seu API Chave)
- A PDF documento em Base64 formato ou um público URL para um PDF arquivo
Formato de resposta
O API retorna um PDF Documento com numeração de páginas adicionada de acordo com suas especificações.