Reemplazar texto con imagen - Reemplazo de imagen API

PDF4me Reemplazar texto con imagen Le permite reemplazar texto específico con imágenes en documentos de Word con opciones avanzadas de filtrado de página y control de tamaño. API El servicio procesa archivos de Word y reemplaza los marcadores de posición de texto con imágenes utilizando coincidencia de texto precisa, tamaño personalizable con preservación de la relación de aspecto, segmentación específica de página y opciones de filtrado flexibles. API recibe el contenido del documento de Word y los datos de imagen a través de REST API llamadas, utilizando Base64 Codificación para una transmisión segura. Con soporte para múltiples formatos de imagen y control total sobre el comportamiento de reemplazo, esta solución es ideal para la automatización de documentos, el procesamiento de plantillas y los flujos de trabajo de inserción dinámica de contenido.

Entradas de blog relacionadas

Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.

Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.

Visita el blog →

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.

Get your api Key

Características principales

• Reemplazo de texto por imagen: Reemplazar cadenas de texto específicas con imágenes en todo el documento.
• Coincidencia de texto precisaBúsqueda y reemplazo de texto que distingue entre mayúsculas y minúsculas
• Control del tamaño de la imagenPersonaliza las dimensiones de la imagen con parámetros de ancho y alto.
• Preservación de la relación de aspectoMantener las proporciones de la imagen durante el redimensionamiento
• Filtrado de páginas: Seleccionar páginas o rangos de páginas específicos para su reemplazo
• Filtrado avanzadoSaltar la primera página, seleccionar páginas pares/impares o especificar números de página exactos.
• Múltiples formatos de imagen: Soporte para PNG, JPG, JPEG, BMP, GIF formatos
• Posicionamiento flexible: Insertar imágenes como formas de Word con posicionamiento preciso

REST API Punto final

El PDF4me REST API utiliza estándar HTTP métodos para interactuar con los recursos. Todas las operaciones de reemplazo de texto por imagen se realizan a través de un único punto final:

• Método: POST
• Punto final: office/ApiV2Word/ReplaceTextWithImage

REST API Parámetros

Lista completa de parámetros para la función Reemplazar texto con imagen 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. Los parámetros avanzados permiten un control preciso del tamaño de las imágenes y del filtrado de páginas.

Parámetros requeridos

Parámetro	Tipo	Descripción	Ejemplo
documento*	Object	Descripción del documento. Debe incluir Nombre (string): generar el nombre del archivo de Word con extensión .docx	{ "Name": "document.docx" }
docContent*	Base64	Contenido del documento de Word codificado en Base64Se realizará una sustitución de texto en este documento. Debe ser un documento de Word válido (formatos .docx o .doc).	base64EncodedDocumentContent
encontrar texto*	String	Cadena de texto que se buscará en el documento. Distingue entre mayúsculas y minúsculas. Todas las instancias se reemplazarán con la imagen. No puede ser nulo ni estar vacío. Ejemplos: "[LOGO]", "SIGN_HERE"	"text to replace"
contenido de la imagen*	Base64	Contenido del archivo de imagen de reemplazo codificado en Base64. Debe ser una imagen válida (PNG, JPG, JPEG, BMP, GIF)	base64EncodedImageContent

Parámetros opcionales

Parámetro	Tipo	Descripción	Ejemplo
ancho	Número (doble)	Ancho de la imagen	200
altura	Número (doble)	Altura de la imagen	100
mantenerRelaciónDeAspecto	Boolean	Mantener las proporciones de la imagen durante el redimensionamiento. Predeterminado: verdadero	true
skipFirstPage	Boolean	Omitir el reemplazo en la primera página. true = saltar la primera página, false = incluir (predeterminado). Útil para portadas/páginas de título.	false
aplicar	String	Alcance objetivo para reemplazo	-
números de página	String	Números de página o rangos específicos (p. ej., "1,2,3" o "1,3,5-7"). Vacío = todas las páginas	"1,2,3"
ignorarNúmerosDePágina	String	Números de página que se excluirán del reemplazo	-
Nombre de la cultura	String	Código cultural (por ejemplo, "en-US", "fr-FR", "de-DE"). Predeterminado: nulo	en-US

Filtrado de páginas

El API Admite el filtrado de páginas mediante los siguientes parámetros:

• skipFirstPage: Controla si se debe omitir la primera página
• números de página: Especifica qué páginas procesar (cadena vacía = todas las páginas)
• ignorarNúmerosDePágina: Números de página a excluir

Formatos de imagen compatibles

Reemplazar texto con imagen API Admite varios formatos de imagen para una máxima compatibilidad:

Formato	Extensión	Descripción
PNG	.png	Gráficos de red portátiles: ideales para logotipos y gráficos con transparencia.
JPEG	.jpg, .jpeg	Grupo Conjunto de Expertos en Fotografía: ideal para fotografías e imágenes complejas.
BMP	.bmp	Mapa de bits: formato sin comprimir, archivos de mayor tamaño.
GIF	.gif	Formato de intercambio de gráficos: admite animación y transparencia.

Producción

El PDF4me Reemplazar texto con imagen REST API devuelve un JSON respuesta (ApiV2WordApiCallRes). En caso de éxito, API devuelve el documento de Word como un Base64cadena codificada en el document campo, no como datos binarios.

Success Response

Respuesta de éxito

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 (string): El documento de Word con texto reemplazado por imágenes, codificado como Base64
• Nombre del archivo (string): El nombre del archivo de Word de salida
• éxito (boolean): Si la operación tuvo éxito
• mensaje de error (string): Mensaje de error si el éxito es falso; de lo contrario, nulo.

Cómo usarlo:

1. Controlar success; si es verdadero, extraiga el document campo del JSON respuesta
2. Decodifica el Base64 cadena para obtener los datos binarios del documento de Word
3. Guarde o procese el archivo de Word usando fileName

Ejemplo (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
if (!data.success) throw new Error(data.errorMessage);
const wordBytes = atob(data.document);
// Save or process wordBytes

Error Responses

Respuestas de error

El API devuelve estándar HTTP Códigos de error con detalles del error:

400 Bad Request

• Parámetros de solicitud no válidos
• Faltan campos obligatorios (documento, docContent, encontrar texto, contenido de la imagen)
• FindText es nulo o vacío
• ImageContent es nulo o vacío
• Inválido Base64 codificación en docContent o contenido de la imagen
• Documento de Word no válido o dañado
• Archivo de imagen no válido o dañado
• Ninguna página coincide con los criterios de filtrado.

401 Unauthorized

• Inválido o faltante API llave
• API La llave no funciona correctamente. Base64 codificado en Authorization encabezado
• Desaparecido Autorización: Básica encabezado

500 Internal Server Error

• Error de procesamiento del servidor
• Error en el procesamiento del documento de Word
• Error en la sustitución de texto
• Error en la inserción de la imagen

Formato de respuesta de error:

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

Response Format Details

Detalles del formato de respuesta

Importante: El API siempre regresa JSON, nunca datos binarios de Word directamente.

Estructura de respuesta (ApiV2WordApiCallRes):

{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": 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(response.fileName, wordBytes);

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 usar Authorization: Basic YWJjMTIz

Carga útil

Ejemplo básico (solo campos obligatorios):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "findText": "text to replace",
 "imageContent": "base64EncodedImageContent",
 "cultureName": "en-US"
}

Ejemplo avanzado (con campos opcionales):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "findText": "text to replace",
 "imageContent": "base64EncodedImageContent",
 "width": 200,
 "height": 100,
 "maintainAspectRatio": true,
 "skipFirstPage": true,
 "pageNumbers": "1,2,3",
 "ignorePageNumbers": null,
 "cultureName": "en-US"
}

Ejemplos de código

El PDF4me Reemplazar texto con imagen 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#

C# (CSharp) Muestra

Completo C# Implementación para reemplazar texto con imágenes en documentos de Word:

View C# Sample

Java

Java Muestra

Java Implementación con manejo completo de errores y procesamiento de respuestas:

View Java Sample

JavaScript

JavaScript Muestra

Node.js y compatible con navegadores JavaScript implementación:

View JavaScript Sample

Python

Python Muestra

Python implementación con la biblioteca requests y JSON manejo:

View Python Sample

Salesforce

Salesforce Muestra

Salesforce Apex implementación para CRM integración:

View Salesforce Sample

n8n

n8n Muestra

n8n Implementación de flujos de trabajo para la automatización:

View n8n Sample

Google Script

Google Script Muestra

Google Apps Script implementación para Google Workspace integración:

View Google Script Sample

AWS Lambda

AWS Lambda Muestra

Sin servidor AWS Lambda Implementación de la función:

View AWS Lambda Sample

Casos de uso y aplicaciones en la industria

Legal & Professional Services

Casos de uso de servicios legales y profesionales

• Procesamiento de contratos: Reemplazar los marcadores de posición de firma con firmas autorizadas
• Automatización de documentos legales: Insertar logotipos y marcas de agua de la empresa en documentos legales
• Personalización de documentos del cliente: Agregar imágenes específicas del cliente a los documentos legales
• Documentación de cumplimiento: Insertar sellos y timbres de conformidad en los documentos

Business & Enterprise

Casos de uso para empresas y negocios

• Generación de propuestas: Insertar logotipos de la empresa e imágenes de productos en las propuestas
• Creación de material de marketing: Reemplazar el texto de marcador de posición con imágenes de marketing
• Automatización de presentaciones a clientes: Insertar imágenes específicas del cliente en las presentaciones
• Generación de informes de ventasInsertar gráficos y tablas de ventas en los informes.

Education & Research

Casos de uso en educación e investigación

• Generación de informes médicos: Insertar gráficos y diagramas médicos en los informes.
• Procesamiento de documentos del paciente: Insertar los logotipos de los centros médicos en los documentos de los pacientes.
• Documentación de investigaciónInsertar tablas y gráficos de investigación en los trabajos de investigación.
• Documentación de cumplimiento: Insertar sellos de cumplimiento médico en los documentos

Finance & Banking

Casos de uso en finanzas y banca

• Generación de informes financierosInsertar gráficos y tablas en los informes financieros.
• Procesamiento de facturas: Reemplazar los marcadores de posición del logotipo con los logotipos de la empresa.
• Documentación de auditoría: Insertar sellos y firmas de auditoría en los informes de auditoría.
• Automatización de informes presupuestarios: Insertar gráficos de presupuesto en los documentos de presupuesto

Obtén ayuda

Get Your API KeyAPI SamplesGetting Started