Excluir páginas do Word - Gerenciamento de páginas API
PDF4me Excluir páginas do Word Permite remover páginas ou intervalos de páginas específicos de documentos do Word com opções flexíveis de seleção de páginas. API O serviço processa arquivos do Word e exclui páginas usando exclusão baseada em intervalo (página inicial à página final), exclusão por número de página específico (listas separadas por vírgula) e padrões de exclusão combinados. API recebe conteúdo de documento Word através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Com suporte para controle total sobre seleção de páginas, otimização de documentos e limpeza de conteúdo, esta solução é ideal para fluxos de trabalho de aprimoramento, gerenciamento de conteúdo e preparação de documentos.
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.
Principais características
- Seleção de página flexívelExcluir páginas por intervalo, números específicos ou uma combinação de ambos
- Exclusão baseada em intervaloRemover páginas consecutivas da página inicial à página final
- Exclusão de página específicaRemova páginas individuais usando números de página separados por vírgulas.
- Otimização de DocumentosLimpe os documentos removendo conteúdo indesejado.
- Preservação de FormatoManter a formatação e a estrutura originais do documento.
- Preservação de MetadadosManter propriedades do documento e metadados personalizados.
- ValidaçãoValidação automática de números de página e tratamento de erros.
- Apoio à CulturaProcessamento de documentos específico para cada localidade
REST API Ponto final
O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todas as operações de exclusão de páginas são realizadas por meio de um único ponto de extremidade:
- Método: POST
- Ponto final:
office/ApiV2Word/DeletePages
REST API Parâmetros
Lista completa de parâmetros para a função Excluir Páginas do Word. 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. Pelo menos um parâmetro de exclusão de página (startPage, endPage ou pageNumbers) deve ser fornecido.
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| documento* | Object | Referência do documento. Deve conter Nome (string): Nome do arquivo Word com extensão .docx | { "Name": "document.docx" } |
| conteúdo do documento* | Base64 | Conteúdo do documento Word codificado em Base64 | UEsDBBQABgAIAAAA... |
Parâmetros opcionais (pelo menos um é necessário para a exclusão da página)
| Parâmetro | Tipo | Descrição | Exemplo |
|---|---|---|---|
| Página inicial | Integer | Número da página inicial (índice baseado em 1). Número da página a partir da qual a exclusão deve começar. Deve ser ≥ 1 e ≤ ao número de páginas do documento. Se apenas a página inicial for fornecida, a exclusão será feita a partir desta página até o final do documento. Não pode ser maior que a página final. | 2 |
| página final | Integer | Número da página final (índice baseado em 1). Número da página em que a exclusão deve ser interrompida. Deve ser ≥ startPage e ≤ número de páginas do documento. O intervalo é inclusivo (as páginas inicial e final serão excluídas). Pode ser combinado com pageNumbers para padrões de exclusão complexos. | 5 |
| Números de página | String | Lista de números de páginas específicos a serem excluídos, separados por vírgulas. Formato: "1,3,4" ou "1-3,5,7-9". Pode ser usado sozinho ou combinado com startPage/endPage. Números de página inválidos são ignorados silenciosamente. Exemplo: "2,4,6,8" exclui as páginas 2, 4, 6 e 8. | "2,4,6" |
| nome_da_cultura | String | Código de cultura para processamento de documentos (ex.: "en-US", "de-DE", "fr-FR"). Padrão: nulo (nenhum processamento específico de cultura). Afeta o idioma e a formatação do documento. | en-US |
Modos de exclusão de página
O API Suporta vários modos de exclusão de páginas:
- Exclusão de intervalo: Usar
startPageeendPagepara excluir páginas consecutivas - Exclusão de página específica: Usar
pageNumberspara excluir páginas individuais - Deleção CombinadaUse parâmetros de intervalo e parâmetros de página específicos em conjunto.
- Apagar para finalizar: Usar somente
startPageexcluir daquela página para documentar o fim
Observação: Todos os números de página são baseados em 1 (primeira página = 1, não 0). Os números de página são validados automaticamente em relação à contagem de páginas do documento.
Saída
O PDF4me Excluir páginas do Word REST API Retorna respostas diferentes dependendo do modo de processamento. API retorna o documento Word como um Base64string codificada em JSON formato, não como dados binários.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Processamento síncrono (padrão)
O API processa a solicitação e retorna:
Código de status: 200 OK
Tipo de conteúdo: application/json
Corpo da resposta:
{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}
Campos de resposta:
- documento (string): O documento do Word com as páginas especificadas excluídas, codificado como Base64 corda
- nome_do_arquivo (string): O nome do arquivo Word de saída
- sucesso (booleano): Indica se a solicitação foi bem-sucedida.
- mensagem de erro (string ou nulo): Detalhes do erro quando o sucesso for falso
Como usar:
- Extraia o
documentcampo do JSON resposta (Base64) - Decifre o Base64 string para obter os dados binários do documento Word
- Salve ou processe o arquivo do Word conforme necessário.
Exemplo (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes
Processamento assíncrono
Comportamento assíncrono (202 Accepted (com polling) é controlado pela configuração do servidor, não por um parâmetro no corpo da requisição. Quando habilitado, o API pode retornar um status 202 com uma pesquisa URL no Location cabeçalho. Consulte o URL com GET Faça solicitações até receber 200. OK com o mesmo formato de resposta (documento, nome do arquivo, sucesso, mensagem de erro).
Respostas de erro
O API retorna padrão HTTP Códigos de erro com detalhes do erro:
- Parâmetros de solicitação inválidos
- Campos obrigatórios ausentes (
documentocomNome,conteúdo do documento) - É necessário pelo menos um critério de exclusão de página (
Página inicial,página final, ouNúmeros de página) - Inválido Base64 codificação em
conteúdo do documento - Documento do Word inválido ou corrompido
Página inicialnão pode ser maior quepágina final- Números de página inválidos (fora do intervalo do documento)
- Inválido ou ausente API chave
- API chave não está corretamente Base64 codificado em Authorization cabeçalho
- Ausente
Autorização: Básicacabeçalho
- Erro de processamento no servidor
- falha no processamento do documento Word
- Falha ao excluir a página
Formato da resposta de erro:
{
"error": "Error message describing what went wrong"
}
Detalhes do formato da resposta
Importante: O API sempre retorna JSON, nunca dados binários do Word diretamente.
Estrutura da resposta:
{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": "string or null"
}
Cabeçalho Content-Type:
- Sucesso:
application/json - O documento do Word 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 documento do Word:
JavaScript/Node.js:
const base64 = response.document;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64'); // Node.js
Python:
import base64
word_bytes = base64.b64decode(response['document'])
with open('output.docx', 'wb') as f:
f.write(word_bytes)
C#:
byte[] wordBytes = Convert.FromBase64String(response.document);
File.WriteAllBytes("output.docx", wordBytes);
Exemplos de exclusão de página
Entendendo diferentes padrões de exclusão de páginas:
| Páginas do documento | Página inicial | página final | Números de página | Resultado |
|---|---|---|---|---|
| 1,2,3,4,5 | 2 | 4 | - | Capacidade: 1,5 |
| 1,2,3,4,5 | 3 | - | - | Contém: 1,2 |
| 1,2,3,4,5 | - | - | "2,4" | Mantém: 1,3,5 |
| 1,2,3,4,5 | 2 | 3 | "5" | Mantém: 1,4 |
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 usarAuthorization: Basic YWJjMTIz
Carga útil
Exemplo básico (exclusão de intervalo):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 4
}
Exemplo de páginas específicas:
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"pageNumbers": "2,4,6,8"
}
Exemplo avançado (exclusão combinada):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 5,
"pageNumbers": "7,9",
"cultureName": "en-US"
}
Exemplos de código
O PDF4me Excluir páginas do Word 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#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# (CSharp) Exemplo
Completo C# Implementação para excluir páginas de documentos do Word:
Java Amostra
Java Implementação com tratamento completo de erros e processamento de respostas:
JavaScript Amostra
Node.js e compatível com navegadores JavaScript Implementação:
Google Script Amostra
Google Apps Script implementação para Google Workspace integração:
Casos de uso e aplicações industriais
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
Casos de uso de serviços jurídicos e profissionais
- Limpeza por contratoRemova as páginas de assinatura e os anexos das cópias do contrato.
- Preparação de Documentos LegaisApague as páginas confidenciais antes de distribuí-las ao cliente.
- Otimização do arquivamento de documentos judiciaisRemova páginas desnecessárias para atender aos requisitos de arquivamento.
- Versões de documentos do clienteCrie versões limpas removendo as notas internas.
Casos de uso para empresas e negócios
- Otimização de PropostasRemover páginas de custos internos das propostas para clientes
- Limpeza de material de marketingExcluir páginas de conteúdo desatualizadas dos materiais atuais
- Preparação da ApresentaçãoRemover slides e anotações de backup das apresentações finais.
- Otimização de entregáveis para o clienteCrie versões limpas removendo referências internas.
Casos de uso em educação e pesquisa
- Limpeza de Relatórios MédicosRemover páginas com informações confidenciais do paciente
- Otimização de Documentos de PesquisaExcluir dados preliminares dos relatórios finais
- Preparação do Documento de ProtocoloRemover páginas de revisão interna de protocolos publicados
- Documentação de ConformidadeLimpar documentos para submissão a órgãos reguladores
Casos de uso em finanças e bancos
- Limpeza do Relatório FinanceiroRemover apêndices detalhados dos resumos executivos
- Otimização de Documentos OrçamentáriosExcluir páginas de dados históricos dos orçamentos atuais
- Preparação do Relatório de AuditoriaRemova as páginas internas sensíveis antes da distribuição externa.
- Limpeza de Arquivos RegulatóriosOtimizar documentos para atender aos requisitos de envio