Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Firmar PDF Firma digital API

PDF4me Firmar PDF te permite agregar imágenes de firma a PDF documentos con control sobre posición, tamaño y apariencia. API procesos de servicio PDF archivos y agrega imágenes de firma usando Base64 codificación para transmisión segura. El API recibe PDF datos de imágenes de contenido y firma a través de REST API llamadas. Esta solución es ideal para la autenticación de documentos, el cumplimiento legal, los flujos de trabajo empresariales y la adición de firmas visuales a los documentos.

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​

  • Compatibilidad con firmas de imágenes: Agregue imágenes de firma personalizadas a PDF documentos con control total sobre el posicionamiento y el tamaño
  • Posicionamiento flexibleControla la alineación horizontal y vertical con precisión milimétrica.
  • Tallas personalizadas: Ajuste las dimensiones de la firma utilizando medidas en milímetros y píxeles.
  • Formato avanzado: Configure la opacidad, los márgenes y las opciones de fondo para una apariencia profesional.
  • Segmentación de páginas: Aplicar firmas a páginas específicas o a documentos completos
  • Control de impresiónConfigure las firmas para que aparezcan solo en la versión impresa o en la pantalla.
  • Resultados profesionales: Crea firmas que mejoren la autenticación y la seguridad de los documentos.
  • Procesamiento asíncrono: Compatibilidad con el procesamiento asíncrono mediante sondeo para operaciones de larga duración.

REST API Punto final​

El PDF4me REST API utiliza estándar HTTP métodos para interactuar con los recursos. Todos PDF Las operaciones de firma se realizan a través de un único punto final:

  • Método: POST
  • Punto final: /api/v2/SignPdf

Compatible PDF Características de firma​

El API proporciona soporte integral para diversos PDF Capacidades de firma:

Soporte de imágenes de firma​

  • Formatos comunes: Soporte para JPG, PNGy otros formatos de imagen estándar
  • Base64 Codificación: Transmisión segura de firmas mediante Base64 codificación
  • Tallas flexiblesOpciones de tamaño basadas tanto en milímetros (10-200 mm) como en píxeles (20-600 px).
  • Preservación de la calidad: Mantiene la calidad de imagen característica en PDF producción

Posicionamiento y diseño​

  • Alineación horizontalOpciones de posicionamiento: izquierda, centro y derecha.
  • Alineación verticalControl de posicionamiento superior, medio e inferior
  • Control de márgenesPosicionamiento preciso con mediciones basadas tanto en milímetros (0-100 mm) como en píxeles (0-300 px).
  • Colocación flexible: Compatibilidad con cualquier posición de página con medidas exactas
  • Segmentación de páginasAplicar a páginas específicas o a documentos completos (opcional)

Características avanzadas​

  • Control de opacidad: Transparencia ajustable (0-100) para firmas sutiles o prominentes
  • Modo de segundo planoOpción para colocar firmas detrás o delante del contenido.
  • Control de impresiónConfigure las firmas para que aparezcan en la vista y se impriman o solo se impriman.
  • Apariencia profesional: Representación de firma de alta calidad con visibilidad clara

REST API Parámetros​

Lista completa de parámetros para el signo PDF 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 y deben proporcionarse para la API para que funcione correctamente.

Parámetros requeridos​

ParámetroTipoDescripciónEjemplo
Nombre del documento*StringProducción PDF Nombre del archivo con extensión .pdfoutput.pdf
docContent*Base64PDF contenido del archivo codificado en Base64JVBERi...
archivo de imagen*Base64Contenido del archivo de imagen de firma codificado en Base64iVBORw0KGgoAAAANSUhEUgAA...
imageName*StringNombre del archivo de imagen de la firma con su extensión (por ejemplo, .jpg, .png)signature.jpg
alinearX*StringAlineación horizontal: Izquierda, Centro, o BienRight
alinearY*StringAlineación vertical: Arriba, Medio, o AbajoBottom

Parámetros opcionales​

ParámetroTipoDescripciónEjemplo
páginasStringOpciones de página: "1", "1,3,5", "2-5", "1,3,7-10", "2-". Si no se especifica, se aplica a todas las páginas.1-3
ancho en mmStringAncho de la firma en milímetros (10-200)50
altura en mmStringAltura de la firma en milímetros (10-200)25
anchoEnPxStringAncho de la firma en píxeles (20-600)142
alturaEnPxStringAltura de la firma en píxeles (20-600)71
margenXEnMMStringMargen horizontal en milímetros (0-100)20
margenYEnMMStringMargen vertical en milímetros (0-100)20
margenXEnPxStringMargen horizontal en píxeles (0-300)57
margenYEnPxStringMargen vertical en píxeles (0-300)57
opacidadStringOpacidad (0-100): 0=invisible, 100=totalmente opaco100
Mostrar solo en formato impresoBooleanMostrar firma en vista e imprimir (verdadero) o solo imprimir (falso)true
es AntecedentesBooleanColocar la firma en segundo plano (verdadero) o en primer plano (falso)false
asíncronoBooleanHabilitar el procesamiento asíncrono. Cuando true, el API devuelve un estado 202 y proporciona una encuesta URL en el Location encabezadotrue

Producción​

El PDF4me Firmar PDF REST API devuelve diferentes respuestas según el modo de procesamiento. API devuelve el PDF como un Base64cadena codificada en JSON formato, no como datos binarios.

Procesamiento síncrono (predeterminado)

Cuando async no está configurado o está configurado false, el API procesa la solicitud inmediatamente:

Código de estado: 200 OK

Content-Type: application/json

Cuerpo de la respuesta:

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

Campos de respuesta:

  • Nombre del documento (cadena): La salida PDF Nombre del archivo
  • docContent (cadena): El PDF archivo con firma añadida, codificado como Base64 cadena

Cómo usarlo:

  1. Extraer el docContent campo del JSON respuesta
  2. Decodifica el Base64 cadena para obtener el binario PDF datos
  3. Guardar o procesar el PDF Archivo según sea necesario

Ejemplo (JavaScript):

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

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):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "alignX": "Right",
  "alignY": "Bottom"
}

Ejemplo avanzado (con todos los campos opcionales):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "widthInMM": "50",
  "heightInMM": "25",
  "widthInPx": "142",
  "heightInPx": "71",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "marginXInPx": "57",
  "marginYInPx": "57",
  "opacity": "100",
  "showOnlyInPrint": true,
  "isBackground": false,
  "async": true
}

Ejemplos de código​

El PDF4me Firmar PDF 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# (CSharp) Muestra

Completo C# implementación para la firma PDF documentos:

PDF Características de firma​

Control de imagen de firma​

  • Compatibilidad con formatos: JPG, PNGGIF y otros formatos de imagen estándar
  • Preservación de la calidad: Mantiene la calidad y resolución de imagen características en PDF producción
  • Base64 Codificación: Transmisión segura de firmas mediante Base64 codificación
  • Tallas flexiblesOpciones de tamaño basadas tanto en milímetros como en píxeles.
  • Apariencia profesional: Representación de firma de alta calidad con visibilidad clara

Posicionamiento y diseño​

  • Control de alineaciónOpciones de alineación horizontal y vertical precisas.
  • Configuración de márgenesPosicionamiento basado tanto en milímetros como en píxeles.
  • Colocación flexible: Compatibilidad con cualquier posición y orientación de página.
  • Segmentación de páginasAplicar a páginas específicas o a documentos completos.
  • Control de tamañoDimensiones personalizables para una colocación óptima.

Características avanzadas​

  • Control de opacidadTransparencia ajustable para firmas sutiles o prominentes.
  • Modo de segundo planoOpción para colocar firmas detrás o delante del contenido.
  • Control de impresiónConfigure las firmas para que aparezcan solo en la versión impresa o en la pantalla.
  • Resultados profesionales: Crea firmas que mejoren la autenticación y la seguridad de los documentos.
  • Posicionamiento flexibleControla la alineación horizontal y vertical con precisión milimétrica.

Casos de uso y aplicaciones en la industria​

Casos de uso de servicios legales y profesionales

  • Documentación legal: Aplicar firmas a contratos legales, acuerdos y documentos oficiales.
  • Firma de contratoFirmar contratos y acuerdos digitalmente para que tengan validez legal.
  • Documentos judicialesAplicar firmas digitales a documentos judiciales y legales.
  • Requisitos de cumplimiento: Cumplir con los requisitos reglamentarios para la firma y autenticación de documentos.

Obtén ayuda​

Get Your API KeyAPI SamplesGetting Started