Asunto: Integración Stirling-PDF: Éxito con PDF-a-Word pero error en Fusionar PDFs (Errores 400/401/Archivo no válido)

Hola comunidad n8n,
​Estoy experimentando un problema desconcertante al integrar Stirling-PDF (alojado por cuenta propia mediante Docker) en mi flujo de trabajo de n8n. He habilitado SECURITY_APIKEY por seguridad.
​La Paradoja:
​Operación Exitosa: Puedo usar exitosamente el endpoint PDF-to-Word. La autenticación mediante el encabezado X-API-KEY funciona perfectamente y el archivo se procesa correctamente.
​Operación Fallida: Cuando cambio al endpoint Merge PDFs (/api/v1/general/merge-pdfs), el proceso falla.
​Los Errores que encuentro:
​A veces recibo un 401 No Autorizado (aunque la misma clave funciona para la conversión).
​Otras veces recibo un 400 Solicitud Incorrecta.
​Con frecuencia, el servidor responde que el archivo es “Inválido” o hay un “Error de Procesamiento”, a pesar de que los PDFs están en buen estado y funcionan en otros nodos.
​Mi Configuración de Flujo de Trabajo para Fusión:
​Método: POST
​Autenticación: Auth de Encabezado con X-API-KEY.
​Tipo de Contenido del Cuerpo: Multipart/form-data.
​Parámetros del Cuerpo: Enviando dos archivos binarios utilizando el nombre de campo fileInput.
​Mis Preguntas para los Expertos:
​Dado que la clave API es válida para conversiones, ¿por qué el endpoint Merge específicamente tiene dificultades con la autenticación o devuelve 400?
​¿Cómo deberían estructurarse múltiples archivos binarios en el nodo HTTP Request para Stirling-PDF? ¿Deberían usar el mismo nombre de campo (fileInput), o hay una convención específica de matriz/nomenclatura requerida?
​¿Hay un requisito específico de manejo de MIME-type o “Content-Length” para la fusión que difiera de la conversión de un solo archivo?
​Agradecería cualquier orientación o un ejemplo funcional de una configuración de Merge de Stirling-PDF en n8n. Última versión de n8n

Hola @abd2001,

Como la clave API es válida para conversiones, ¿por qué el endpoint Merge específicamente tiene problemas con la autenticación o devuelve 400?

Ya que el endpoint merge-pdfs tiene algunos parámetros requeridos en el cuerpo de la solicitud, asegúrate de que tu solicitud tenga los siguientes detalles:

  • fileInput: array de archivos pdf
  • sortType: ‘orderProvided’, ‘byFileName’, ‘byDateModified’
  • removeCertSign: true
  • generateToc: false

se ve así:

referencia:
https://registry.scalar.com/@stirlingpdf/apis/stirling-pdf-processing-api/#tag/general/POST/api/v1/general/merge-pdfs