Eliminar páginas de Word - Gestión de páginas API
PDF4me Eliminar páginas de Word Le permite eliminar páginas o rangos de páginas específicos de documentos de Word con opciones de selección de página flexibles. API El servicio procesa archivos de Word y elimina páginas utilizando eliminación basada en rangos (desde la página inicial hasta la página final), eliminación de números de página específicos (listas separadas por comas) y patrones de eliminación combinados. API recibe el contenido del documento de Word a través de REST API llamadas, utilizando Base64 Codificación para una transmisión segura. Con soporte para control total sobre la selección de páginas, optimización de documentos y limpieza de contenido, esta solución es ideal para flujos de trabajo de refinamiento, gestión de contenido y preparación de documentos.
Autenticando su API Pedido
Para acceder al PDF4me REST APICada solicitud debe incluir las credenciales de autenticación adecuadas. La autenticación garantiza una comunicación segura y valida su identidad como usuario autorizado del sistema. REST API.
Características principales
- Selección de página flexibleEliminar páginas por rango, números específicos o una combinación de ambos.
- Eliminación basada en rangos: Eliminar páginas consecutivas desde la página de inicio hasta la página final.
- Eliminación de página específicaEliminar páginas individuales utilizando números de página separados por comas.
- Optimización de documentos: Limpiar documentos eliminando contenido no deseado
- Preservación del formatoMantener el formato y la estructura originales del documento.
- Preservación de metadatos: Conservar las propiedades del documento y los metadatos personalizados.
- ValidaciónValidación automática del número de página y gestión de errores.
- Apoyo culturalProcesamiento de documentos específico de la configuración regional
REST API Punto final
El PDF4me REST API utiliza estándar HTTP métodos para interactuar con los recursos. Todas las operaciones de eliminación de páginas se realizan a través de un único punto final:
- Método: POST
- Punto final:
office/ApiV2Word/DeletePages
REST API Parámetros
Lista completa de parámetros para la función Eliminar páginas de Word REST APILos parámetros están organizados por categoría para una mejor comprensión e implementación.
Importante: Los parámetros marcados con un asterisco (*) son obligatorios. Se debe proporcionar al menos un parámetro de eliminación de página (startPage, endPage o pageNumbers).
Parámetros requeridos
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| documento* | Object | Referencia del documento. Debe contener Nombre (cadena): Nombre del archivo de Word con extensión .docx | { "Name": "document.docx" } |
| docContent* | Base64 | Contenido del documento de Word codificado en Base64 | UEsDBBQABgAIAAAA... |
Parámetros opcionales (se requiere al menos uno para eliminar la página)
| Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| Página de inicio | Integer | Número de página de inicio (índice basado en 1). Número de página desde donde comenzar a eliminar. Debe ser ≥ 1 y ≤ número de páginas del documento. Si solo se proporciona startPage, se eliminará desde esta página hasta el final del documento. No puede ser mayor que endPage. | 2 |
| Fin de página | Integer | Número de página final (índice basado en 1). Número de página donde se detendrá la eliminación. Debe ser ≥ startPage y ≤ número de páginas del documento. El rango es inclusivo (se eliminan tanto la página inicial como la final). Se puede combinar con pageNumbers para patrones de eliminación complejos. | 5 |
| números de página | String | Lista de números de página específicos separados por comas para eliminar. Formato: "1,3,4" o "1-3,5,7-9". Puede usarse sola o combinada con startPage/endPage. Los números de página no válidos se ignoran silenciosamente. Ejemplo: "2,4,6,8" elimina las páginas 2, 4, 6 y 8. | "2,4,6" |
| Nombre de la cultura | String | Código cultural para el procesamiento de documentos (p. ej., "en-US", "de-DE", "fr-FR"). Valor predeterminado: nulo (sin procesamiento específico de la cultura). Afecta al idioma y al formato del documento. | en-US |
Modos de eliminación de páginas
El API Admite varios modos de eliminación de páginas:
- Eliminación de rango: Usar
startPageyendPagepara eliminar páginas consecutivas - Eliminación de página específica: Usar
pageNumberspara eliminar páginas individuales - Eliminación combinada: Utilice parámetros de rango y de página específicos simultáneamente.
- Eliminar para finalizar: Usar solo
startPagepara eliminar de esa página hasta el final del documento
Nota: Todos los números de página se basan en 1 (la primera página es 1, no 0). Los números de página se validan automáticamente con respecto al número de páginas del documento.
Producción
El PDF4me Eliminar páginas de Word REST API devuelve diferentes respuestas según el modo de procesamiento. API devuelve el documento de Word como un Base64cadena codificada en JSON formato, no como datos binarios.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Procesamiento síncrono (predeterminado)
El API procesa la solicitud y devuelve:
Código de estado: 200 OK
Tipo de contenido: application/json
Cuerpo de la respuesta:
{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}
Campos de respuesta:
- documento (cadena): El documento de Word con las páginas especificadas eliminadas, codificado como Base64 cadena
- Nombre del archivo (cadena): El nombre del archivo Word de salida
- éxito (booleano): Indica si la solicitud se realizó correctamente.
- mensaje de error (cadena o nulo): Detalles del error cuando el éxito es falso.
Cómo usarlo:
- Extraer el
documentcampo del JSON respuesta (Base64) - Decodifica el Base64 cadena para obtener los datos binarios del documento de Word
- Guarde o procese el archivo de Word según sea necesario.
Ejemplo (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes
Procesamiento asíncrono
Comportamiento asíncrono (202 Accepted con sondeo) se controla mediante la configuración del servidor, no mediante un parámetro del cuerpo de la solicitud. Cuando está habilitado, el API puede devolver un estado 202 con una encuesta URL en el Location encabezado. Sondear el URL con GET solicitudes hasta que reciba 200 OK con la misma estructura de respuesta (documento, nombre de archivo, éxito, mensaje de error).
Respuestas de error
El API devuelve estándar HTTP Códigos de error con detalles del error:
- Parámetros de solicitud no válidos
- Faltan campos obligatorios (
documentoconNombre,docContent) - Se requiere al menos un criterio de eliminación de página (
Página de inicio,Fin de página, onúmeros de página) - Inválido Base64 codificación en
docContent - Documento de Word no válido o dañado
Página de iniciono puede ser mayor queFin de página- Números de página no válidos (fuera del rango del documento)
- Inválido o faltante API llave
- API La llave no funciona correctamente. Base64 codificado en Authorization encabezado
- Desaparecido
Autorización: Básicaencabezado
- Error de procesamiento del servidor
- Error en el procesamiento del documento de Word
- Error al eliminar la página
Formato de respuesta de error:
{
"error": "Error message describing what went wrong"
}
Detalles del formato de respuesta
Importante: El API siempre regresa JSON, nunca datos binarios de Word directamente.
Estructura de respuesta:
{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": "string or null"
}
Encabezado de tipo de contenido:
- Éxito:
application/json - El documento de Word está incrustado como un Base64 cadena dentro de la JSON respuesta
Por qué Base64¿
- JSON-Codificación segura para datos binarios
- Fácil de transmitir HTTP
- Compatible con todos los lenguajes de programación.
- Se puede integrar directamente en JSON sin escapar de los problemas
Decodificación Base64 al documento de 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);
Ejemplos de eliminación de páginas
Comprender los diferentes patrones de eliminación de páginas:
| Páginas del documento | Página de inicio | Fin de página | números de página | Resultado |
|---|---|---|---|---|
| 1,2,3,4,5 | 2 | 4 | - | Conservas: 1,5 |
| 1,2,3,4,5 | 3 | - | - | Conservaciones: 1,2 |
| 1,2,3,4,5 | - | - | "2,4" | Conservaciones: 1,3,5 |
| 1,2,3,4,5 | 2 | 3 | "5" | Conservaciones: 1,4 |
Ejemplo de solicitud
Encabezamiento
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Nota:
- Consigue tu API clave del PDF4me Panel
- El API La clave debe ser Base64 codificado y prefijado con "Basic" en el Authorization encabezado
- Ejemplo: Si su API La clave es
abc123, codificarlo a Base64 y usarAuthorization: Basic YWJjMTIz
Carga útil
Ejemplo básico (eliminación de rango):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 4
}
Ejemplo de páginas específicas:
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"pageNumbers": "2,4,6,8"
}
Ejemplo avanzado (eliminación combinada):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 5,
"pageNumbers": "7,9",
"cultureName": "en-US"
}
Ejemplos de código
El PDF4me Eliminar páginas de Word REST API Proporciona ejemplos de código en varios lenguajes de programación. Elija el lenguaje que mejor se adapte a su entorno de desarrollo:
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# (CSharp) Muestra
Completo C# Implementación para eliminar páginas de documentos de Word:
Java Muestra
Java Implementación con manejo completo de errores y procesamiento de respuestas:
JavaScript Muestra
Node.js y compatible con navegadores JavaScript implementación:
Google Script Muestra
Google Apps Script implementación para Google Workspace integración:
Casos de uso y aplicaciones en la industria
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
Casos de uso de servicios legales y profesionales
- Limpieza por contratoEliminar las páginas de firmas y los anexos de las copias del contrato.
- Preparación de documentos legalesElimine las páginas confidenciales antes de distribuirlas al cliente.
- Optimización de la presentación de documentos judiciales: Elimine las páginas innecesarias para cumplir con los requisitos de presentación.
- Versiones de los documentos del cliente: Crea versiones limpias eliminando las notas internas
Casos de uso para empresas y negocios
- Optimización de propuestasEliminar las páginas de costos internos de las propuestas para clientes.
- Limpieza de material de marketingEliminar las páginas de contenido obsoletas de los materiales actuales.
- Preparación de la presentación: Eliminar las diapositivas y notas de respaldo de las presentaciones finales.
- Optimización de los entregables para el cliente: Crea versiones limpias eliminando las referencias internas.
Casos de uso en educación e investigación
- Limpieza de informes médicosEliminar páginas con información confidencial del paciente
- Optimización de documentos de investigaciónEliminar los datos preliminares de los informes finales.
- Preparación de documentos de protocolo: Eliminar las páginas de revisión interna de los protocolos publicados
- Documentación de cumplimiento: Limpiar los documentos para las presentaciones regulatorias
Casos de uso en finanzas y banca
- Limpieza de informes financierosEliminar los apéndices detallados de los resúmenes ejecutivos.
- Optimización de documentos presupuestarios: Eliminar páginas de datos históricos de los presupuestos actuales
- Preparación de informes de auditoría: Eliminar las páginas internas sensibles antes de la distribución externa.
- Limpieza de expedientes regulatoriosOptimizar los documentos para cumplir con los requisitos de presentación.