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:
-
Mudar para o modo raw body em vez de depender do tratamento multipart automático do n8n. Isso te dá controle.
-
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).
-
Nomenclatura de campos: Use
files(plural) como o nome do campo, nãofileInput. O endpoint de merge do Stirling-PDF especificamente espera isso. Algumas versões usam a sintaxefile[]—teste ambos. -
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?