Firmar PDF
Editar → Firmar PDF
El Firmar PDF API coloca una imagen de firma en tu PDF. Tú envías el PDF (docContent, docName), la imagen de la firma (imageFile Base64, imageName), alignX y alignY, opcional pages, tamaño (mm o px), márgenes, opacity, showOnlyInPrint, isBackground, y async. El API devuelve el PDF Con la firma aplicada. Utilice el probador que aparece a continuación para comprobarlo; encontrará más detalles en las secciones siguientes.
Prueba el letrero PDF API
:::nota Referencia rápida
Punto final: POST /api/v2/SignPdf · Requerido: api-key, docContent, docName, imageFile, imageName, alignX, alignY
:::
Utiliza el formulario a continuación para enviar tu solicitud API llave, PDF (Base64), y la imagen de la firma (Base64). La respuesta es la PDF con la firma. No se requiere código, complete los campos y haga clic. Enviar solicitud.
Descripción general, parámetros y casos de uso
- Overview
- Parameters
- Use cases
¿Qué es un signo? PDF¿
Este punto final coloca una imagen de firma en páginas específicas de un PDF. Usted proporciona el PDF (Base64), la imagen de la firma (Base64), posición (alignX, alignY), opcional pages, tamaño (widthInMM/heightInMM o widthInPx/heightInPx), márgenes en mm o px, opacity (0-100), showOnlyInPrint, y isBackground. El API devuelve el PDF Con la firma aplicada. Ideal para añadir firmas visuales a contratos, formularios o cartas.
Características principales
- Imagen de firma: imageFile (Base64), imageName (p. ej., signature.jpg).
- Posición y tamaño: alignX (Izquierda, Centro, Derecha), alignY (Superior, Medio, Inferior); tamaño en mm (10-200) o px (20-600); márgenes en mm o px.
- Opacidad: 0 = invisible, 100 = totalmente opaco (normalmente 100 para firmas).
- Segmentación de páginas: pages: p.ej. 1, 1,3,5, 2-5, 1,3,7-10, 2-.
- showOnlyInPrint: Mostrar firma solo al imprimir; isBackground lo coloca detrás o delante del contenido.
Usar para firmas visuales en contratos, formularios o documentos de aprobación. Para marcas de agua o sellos de imagen, usar Agregar sello de imagen a PDF; para marcas de agua de texto utilice Agregar sello de texto a PDF.
API parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| api-key | cadena | Sí | Su PDF4me API llave, Base64 codificado. Consíguelo desde el panel. |
| docContent | base64 | Sí | PDF contenido del archivo (Base64). |
| docName | cadena | Sí | Producción PDF nombre del archivo (por ejemplo, output.pdf). |
| imageFile | base64 | Sí | Contenido de la imagen de firma (Base64). |
| imageName | cadena | Sí | Nombre de la imagen de la firma con extensión (por ejemplo, signature.jpg). |
| alignX, alignY | cadena | Sí | Izquierda/Centro/Derecha; Arriba/Medio/Abajo. |
| pages | cadena | No | p.ej. 1, 1,3,5, 2-5, 1,3,7-10, 2-. |
| widthInMM, heightInMM | cadena | No | Tamaño en mm (10-200). |
| widthInPx, heightInPx | cadena | No | Tamaño en píxeles (20-600). |
| marginXInMM, marginYInMM, marginXInPx, marginYInPx | cadena | No | Márgenes en mm o px. |
| opacity | cadena | No | 0-100. |
| showOnlyInPrint | booleano | No | Mostrar solo al imprimir. |
| isBackground | booleano | No | Colocar la firma en segundo plano. |
| async | booleano | No | Habilitar el procesamiento asíncrono. |
Cuándo usar Sign PDF
- Contratos y acuerdos: Añadir una imagen de firma visual a los documentos firmados.
- Formularios y aprobaciones: Firme los formularios de aprobación o consentimiento.
- Cartas e informes: Añadir la firma del autor o del firmante a las cartas o informes.
- Flujos de trabajo: Automatizar la colocación de una imagen de firma almacenada en generada PDFs.
Para ver esquemas de solicitud/respuesta y ejemplos de código, consulte Firmar PDF en el PDF4me API documentos.
Requisitos previos
Antes de utilizar este punto final, asegúrese de tener:
- Un válido PDF4me API llave (Consigue tu API Llave)
- A PDF documento en Base64 formato o público URL a un PDF archivo
- Un archivo de imagen de firma (JPG, PNG, etc.)
Formato de respuesta
El API devuelve un PDF documento con la imagen de la firma aplicada a las páginas especificadas.