Adicionar número de página ao PDF - Paginação API

PDF4me Adicionar número de página ao PDF Permite adicionar números de página personalizáveis a PDF documentos com controle sobre posição, formatação e estilo. Isto API processos de serviço PDF arquivos e adiciona números de página usando marcadores de formato onde # representa o número da página atual e {1} representa o número total de páginas. API recebe PDF conteúdo através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Esta solução é ideal para organização de documentos, documentação jurídica, trabalhos acadêmicos e aplicações empresariais. PDF fluxos de trabalho.

Artigos relacionados no blogue

Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.

Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.

Visite o blogue →

Autenticando seu API Solicitar

Para acessar o PDF4me REST APIPara que uma solicitação seja aceita, é necessário incluir as credenciais de autenticação adequadas. A autenticação garante a segurança da comunicação e valida sua identidade como usuário autorizado do sistema. REST API.

Obtenha sua chave de API.

Principais características

• Formatação flexívelEscolha entre vários formatos de número de página usando # para a página atual e {1} para o total de páginas (por exemplo, "# de 1", "Página nº")
• Posicionamento precisoControle o alinhamento horizontal e vertical com precisão perfeita de pixels.
• Estilização personalizadaAjuste o tamanho da fonte, negrito, itálico e outras opções de formatação de texto.
• Controle de MargemDefina margens precisas em milímetros para um posicionamento ideal.
• Pular para a primeira páginaOpção para excluir os números de página da primeira página.
• Resultados profissionaisCrie uma numeração de páginas consistente e profissional em todos os documentos.

REST API Ponto final

O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todas as operações de adição de número de página são realizadas por meio de um único ponto de extremidade:

• Método: PUBLICAR
• Ponto final: /api/v2/AddPageNumber

REST API Parâmetros

Lista completa de parâmetros para Adicionar Número de Página PDF REST APIOs parâmetros estão organizados por categoria para melhor compreensão e implementação.

Importante: Os parâmetros marcados com um asterisco (*) são obrigatórios e devem ser fornecidos para o API para funcionar corretamente.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição	Exemplo
nomeDoDocumento*	Corda	Saída PDF nome do arquivo com extensão .pdf	output.pdf
conteúdo do documento*	Base64	PDF conteúdo do arquivo codificado em Base64	JVBERi...
formatoNúmeroDaPágina*	Corda	Formato de número de página. Use # para o número da página atual, {1} para o total de páginas. Exemplos: "# de 1", "Página #", "# / 1"	# of {1}
alinharX*	Corda	Alinhamento horizontal: esquerda, centro, ou certo	right
alinharY*	Corda	Alinhamento vertical: principal, meio, ou fundo	bottom

Parâmetros opcionais

Parâmetro	Tipo	Descrição	Exemplo
margemXinMM	Número inteiro	Margem horizontal a partir da borda em milímetros (0-100)	2
margemEmMM	Número inteiro	Margem vertical a partir da borda em milímetros (0-100)	2
tamanho da fonte	Número inteiro	Tamanho da fonte para números de página (8-72)	12
bola de gelo	Booleano	Exibir os números de página em negrito (verdadeiro) ou em fonte normal (falso).	true
é itálico	Booleano	Exibir os números de página em itálico (verdadeiro) ou normal (falso)	false
pularPrimeiraPágina	Booleano	Ignorar a numeração na primeira página (verdadeiro) ou incluí-la (falso)	false
assíncrono	Booleano	Ative o processamento assíncrono. Quando true, o API retorna o status 202 e fornece uma opção de sondagem. URL no Location cabeçalho	true

Formato de número de página

O pageNumberFormat O parâmetro utiliza os seguintes marcadores de posição:

• # - Substituído pelo número da página atual (1, 2, 3, etc.)
• {1} - Substituído pelo número total de páginas

Exemplos de formato:

• "# of {1}" → Exibe "1 de 10", "2 de 10", "3 de 10", etc.
• "Page #" → Exibe "Página 1", "Página 2", "Página 3", etc.
• "# / {1}" → Exibe "1 / 10", "2 / 10", "3 / 10", etc.
• "- # -" → Exibe "- 1 -", "- 2 -", "- 3 -", etc.
• "[#/{1}]" → Exibe "[1/10]", "[2/10]", "[3/10]", etc.
• "(#)" → Exibe "(1)", "(2)", "(3)", etc.
• "#" → Exibe apenas o número da página: "1", "2", "3", etc.

Saída

O PDF4me Adicionar número de página ao PDF REST API Retorna respostas diferentes dependendo do modo de processamento. API retorna o PDF como um Base64string codificada em JSON formato, não como dados binários.

Success Response

Processamento síncrono (padrão)

Quando async não está definido ou está definido como false, o API processa a solicitação imediatamente:

Código de status: 200 OK

Content-Type: application/json

Corpo da resposta:

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Campos de resposta:

• nomeDoDocumento (string): A saída PDF nome do arquivo
• conteúdo do documento (string): O PDF arquivo com números de página adicionados, codificado como Base64 corda

Como usar:

1. Extraia o docContent campo do JSON resposta
2. Decifre o Base64 string para obter o binário PDF dados
3. Salvar ou processar o PDF arquive conforme necessário

Exemplo (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

Asynchronous Processing

Processamento assíncrono

Quando async: true está definido, o API processa a solicitação de forma assíncrona:

Código de status: 202 Accepted

Cabeçalhos de resposta:

Location: https://api.pdf4me.com/api/v2/AddPageNumber/poll/12345-abcde-67890

Processo de votação:

1. Extraia o Location cabeçalho da resposta 202
2. Faça a pesquisa URL usando GET solicitações
3. Continue votando até receber um 200 OK status
4. A resposta final contém o mesmo JSON formato com docName e docContent (Base64)

Exemplo de votação:

// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');

// Poll until complete
while (true) {
  const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
  if (pollResponse.status === 200) {
    const data = await pollResponse.json();
    // Process data.docContent (Base64 PDF)
    break;
  }
  await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}

Error Responses

Respostas de erro

O API retorna padrão HTTP Códigos de erro com detalhes do erro:

400 Bad Request

• Parâmetros de solicitação inválidos
• Campos obrigatórios ausentes (conteúdo do documento, nomeDoDocumento, formatoNúmeroDaPágina, alinharX, alinharY)
• Inválido Base64 codificação em conteúdo do documento
• Valores de alinhamento inválidos (devem ser "esquerda", "centro", "direita" para alinhamento X; "superior", "médio", "inferior" para alinhamento Y)
• Tamanho de fonte inválido (deve estar entre 8 e 72)
• Valores de margem inválidos (devem ser números inteiros entre 0 e 100)

401 Unauthorized

• Inválido ou ausente API chave
• API chave não está corretamente Base64 codificado em Authorization cabeçalho
• Ausente Autorização: Básica cabeçalho

500 Internal Server Error

• Erro de processamento no servidor
• PDF falha de processamento
• Falha na adição do número da página

Formato da resposta de erro:

{
  "error": "Error message describing what went wrong"
}

Response Format Details

Detalhes do formato da resposta

Importante: O API sempre retorna JSON, nunca binário PDF dados diretamente.

Estrutura da resposta:

{
  "docName": "string",      // Output PDF filename
  "docContent": "string"    // Base64-encoded PDF content
}

Content-Type Cabeçalho:

• Sucesso: application/json
• O PDF está incorporado como um Base64 string dentro do JSON resposta

Por que Base64?

• JSON-Codificação segura para dados binários
• Fácil de transmitir HTTP
• Compatível com todas as linguagens de programação.
• Pode ser incorporado diretamente em JSON sem escapar dos problemas

Decodificando Base64 para PDF:

JavaScript/Node.js:

const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js

Python:

import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
    f.write(pdf_bytes)

C#:

byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", pdfBytes);

Exemplo de solicitação

Cabeçalho

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Observação:

• Adquira o seu API chave do PDF4me Painel
• O API a chave deve ser Base64 codificado e prefixado com "Básico" no Authorization cabeçalho
• Exemplo: Se o seu API chave é abc123, codifique-o para Base64 e usar Authorization: Basic YWJjMTIz

Carga útil

Exemplo básico (somente campos obrigatórios):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pageNumberFormat": "# of {1}",
  "alignX": "right",
  "alignY": "bottom"
}

Exemplo avançado (com todos os campos opcionais):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pageNumberFormat": "# of {1}",
  "alignX": "right",
  "alignY": "bottom",
  "marginXinMM": 2,
  "marginYinMM": 2,
  "fontSize": 12,
  "isBold": true,
  "isItalic": false,
  "skipFirstPage": false,
  "async": true
}

Exemplos de código

O PDF4me Adicionar número de página ao PDF REST API Fornece exemplos de código em várias linguagens de programação. Escolha a linguagem que melhor se adapta ao seu ambiente de desenvolvimento:

C#

C# (CSharp) Exemplo

Completo C# Implementação para adicionar números de página ao PDF:

View C# Sample

Java

Java Amostra

Java Implementação com tratamento completo de erros e processamento de respostas:

View Java Sample

JavaScript

JavaScript Amostra

Node.js e compatível com navegadores JavaScript Implementação:

View JavaScript Sample

Python

Python Amostra

Python implementação com a biblioteca requests e JSON manuseio:

View Python Sample

Salesforce

Salesforce Amostra

Salesforce implementação com Apex e HTTP chamadas:

View Salesforce Sample

n8n

n8n Amostra

n8n implementação de fluxo de trabalho com HTTP nós de solicitação:

View n8n Sample

Google Script

Google Script Amostra

Google Apps Script Implementação com UrlFetchApp:

View Google Script Sample

AWS Lambda

AWS Lambda Amostra

AWS Lambda implementação com Node.js e API Portal:

View AWS Lambda Sample

Recursos de número de página

Opções de formatação

• Vários formatosSuporte para diversos estilos e padrões de numeração.
• Posicionamento flexívelControle preciso sobre o posicionamento dos números de página.
• Estilização personalizadaControle total sobre a aparência e formatação da fonte.
• Controle da primeira páginaOpção para excluir as páginas de rosto da numeração.

Aprimoramento de Documentos

• Layout profissionalCrie uma numeração de páginas consistente e profissional em todos os documentos.
• Otimização de ImpressãoOtimizar a numeração de páginas para diferentes requisitos de impressão
• Distribuição DigitalManter a formatação em diferentes dispositivos de visualização.
• Consistência da marcaAplicar padrões uniformes de numeração de páginas em todas as organizações.

Recursos avançados

• Processamento em loteProcessar vários documentos com numeração de páginas consistente.
• Garantia de QualidadeGarantir a integridade e a correta numeração das páginas. PDF compatibilidade
• Preservação do LayoutMantenha a estrutura do documento ao adicionar números de página.
• Margens personalizadasControle preciso sobre o posicionamento da numeração de páginas

Casos de uso e aplicações industriais

Legal & Professional Services

Casos de uso de serviços jurídicos e profissionais

• Documentação LegalNumere as páginas em contratos, acordos e documentos jurídicos.
• Documentos judiciaisAdicionar números de página a documentos judiciais e legais.
• Documentação de ConformidadeNumere as páginas em documentos de conformidade e regulamentação.
• Documentação do ClienteOrganize os documentos do cliente com numeração de páginas.

Education & Research

Casos de uso em educação e pesquisa

• Artigos acadêmicosFormatar trabalhos de pesquisa e teses com numeração de páginas adequada.
• Documentos de pesquisaAdicionar números de página a artigos de pesquisa e publicações.
• Formatação de teseNumere as páginas em teses e dissertações.
• Materiais EducacionaisOrganize documentos educacionais com números de página.

Business & Enterprise

Casos de uso para empresas e negócios

• Relatórios de negóciosCrie relatórios profissionais com numeração de páginas consistente.
• Organização de DocumentosAdicionar números de página a relatórios, manuais e documentos técnicos.
• Manuais técnicosOrganize a documentação técnica com referências de página claras.
• Documentação CorporativaNumere as páginas em documentos e manuais corporativos.

Government & Compliance

Casos de uso para governo e conformidade

• Documentos de arquivoPrepare documentos para armazenamento a longo prazo com numeração de páginas.
• Relatórios governamentaisAdicionar números de página a relatórios e documentos governamentais.
• Documentação regulamentarNumere as páginas em documentos regulatórios e de conformidade.
• Registros PúblicosOrganizar registros públicos com numeração de páginas

Obtenha ajuda

Get Your API KeyAPI SamplesGetting Started