API de conversão

Autenticação

Gere sua chave na página Conta e envie no cabeçalho Authorization. O cabeçalho X-API-Key também funciona.

Authorization: Bearer cvk_sua_chave

Converter um arquivo

POST /api/v1/convert/{ferramenta} com multipart/form-data. O arquivo vai no campo file e as opções, se houver, em campos de texto.

curl -X POST https://seu-app.onrender.com/api/v1/convert/svg-para-pdf \
  -H "Authorization: Bearer cvk_sua_chave" \
  -F "file=@logo.svg" \
  -o logo.pdf

Com opções:

curl -X POST https://seu-app.onrender.com/api/v1/convert/svg-para-png \
  -H "Authorization: Bearer cvk_sua_chave" \
  -F "file=@logo.svg" -F "width=1200" \
  -o logo.png

A resposta é o arquivo convertido. Quando o resultado tem vários arquivos (PDF com várias páginas para imagens, planilha com várias abas para CSV, ou um lote), a resposta é um ZIP. O nome sugerido vem em Content-Disposition.

Lote e vários arquivos

Repita o campo file para enviar até 50 arquivos de uma vez. Cada arquivo conta como uma conversão e o retorno é um ZIP. Em juntar-pdf e jpg-para-pdf, os arquivos são combinados na ordem enviada e contam como uma conversão.

curl -X POST https://seu-app.onrender.com/api/v1/convert/juntar-pdf \
  -H "Authorization: Bearer cvk_sua_chave" \
  -F "file=@parte1.pdf" -F "file=@parte2.pdf" \
  -o completo.pdf

Cabeçalhos de resposta

Erros

Erros voltam como JSON: { "error": "mensagem", "code": "codigo" }.

Ferramentas e opções

A lista também está em GET /api/v1/tools, sem autenticação.