Assunto: Endpoint de Mesclar PDF com falha no Stirling-PDF (Docker) via n8n - Enquanto outros endpoints funcionam normalmente. Oi a todos,

Estou enfrentando um problema persistente com o endpoint Merge PDFs no Stirling-PDF enquanto uso o n8n. Espero que alguém possa esclarecer a configuração correta.
​Meu Ambiente:
​Implantação: Tanto o n8n quanto o Stirling-PDF estão sendo executados em contêineres Docker separados na mesma máquina.
​Autenticação: SECURITY_APIKEY está habilitada nas variáveis de ambiente do Docker do Stirling-PDF.
​Rede: o n8n se comunica com o Stirling-PDF por meio do nome do contêiner/IP e porta 8080.
​O Problema:
​Sucesso: Consigo usar com sucesso o endpoint PDF to Word. A autenticação (cabeçalho X-API-KEY) funciona perfeitamente e o arquivo é processado.
​Falha: Quando tento usar o endpoint Merge PDFs (/api/v1/general/merge-pdfs), recebo erros como 400 (Bad Request), 401 (Unauthorized) ou 411 (Length Required).
​Mensagem de Erro: Às vezes, a resposta indica “Invalid PDF” ou “Missing files”, mesmo que os arquivos binários sejam passados corretamente do nó anterior do n8n.
​Detalhes Técnicos no n8n:
​Método: POST.
​Tipo de Conteúdo do Body: Multipart/form-data.
​Campos do Body: Estou enviando dois arquivos usando o nome do campo fileInput para ambos (conforme a documentação do Stirling-PDF), mas parece falhar durante o processo de mesclagem.
​Minha Pergunta:
Como a autenticação funciona para outras tarefas, qual é o requisito específico para o endpoint Merge em uma configuração Docker-to-Docker? O Stirling-PDF espera uma convenção de nomenclatura de campo diferente para vários arquivos ou uma estrutura de array específica na solicitação multipart?
​Qualquer ajuda será muito apreciada!

Olá,

Aqui está o que pode estar realmente acontecendo.
Quando você usa fileInput para ambos os arquivos, o endpoint de merge do Stirling-PDF precisa deles como uma estrutura de array, não nomes de campos duplicados. A maioria dos endpoints é tolerante com isso. O endpoint de merge não é. Você provavelmente está recebendo um 400 porque o backend não consegue fazer parse do array de arquivos corretamente, ou um 411 porque o header Content-Length não está sendo calculado adequadamente quando o n8n constrói o payload multipart.

A solução—e esta é a parte crítica.
No seu nó HTTP Request do n8n, você precisa:

  1. Mudar para o modo raw body em vez de depender do tratamento multipart automático do n8n. Isso te dá controle.

  2. Construir a boundary multipart manualmente ou usar um nó de biblioteca multipart apropriado se o n8n suportar (verifique a documentação do nó HTTP Request para a versão mais recente).

  3. Nomenclatura de campos: Use files (plural) como o nome do campo, não fileInput. O endpoint de merge do Stirling-PDF especificamente espera isso. Algumas versões usam a sintaxe file[]—teste ambos.

  4. Garanta que Content-Length está definido explicitamente. O erro 411 grita falta de header Content-Length. O n8n às vezes remove isso na comunicação Docker-para-Docker.

O header de autenticação permanece igual—sua X-API-KEY está boa. Mas adicione Content-Type: multipart/form-data; boundary=----YourBoundaryHere explicitamente.

Detalhe de rede Docker: Como você está container-para-container, certifique-se de que está usando o nome do serviço (stirling-pdf:8080 se esse for o nome do seu container) na URL, não localhost. Você provavelmente já está fazendo isso já que PDF para Word funciona, mas vale a pena confirmar.

Mais uma coisa—verifique os logs do Stirling-PDF diretamente. Execute docker logs <stirling-pdf-container-name> e procure pelo erro real do endpoint de merge. Às vezes dirá “missing field: files” ou “invalid multipart structure”—isso te diz exatamente o que corrigir.

Qual versão do Stirling-PDF você está usando, e você pode compartilhar uma captura de tela de como você está atualmente configurando o body no n8n?