convertajá

API · Escritório e negócios

Aplicar papel timbrado via API

Coloque o timbrado da empresa em todas as páginas de vários PDFs de uma vez. Integre no seu sistema com uma chamada: POST /v1/tools/papel-timbrado.

Custo1 crédito por arquivo
TipoLeve
Arquivos1 ou mais
Formatospdf

Exemplo

curl -X POST "https://convertaja.com.br/v1/tools/papel-timbrado?wait=true" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -F "files=@arquivo1.pdf" \
  -F "letterhead=@letterhead.pdf" \
  -F 'options={"pages":"first","fit":"over"}'

Opções

Envie em options (JSON) ou como campos do formulário. Opções desconhecidas são recusadas com 400 invalid_option.

OpçãoTipoDescrição e valoresPadrão
useSavedLetterheadbooleanUsar o papel timbrado salvo no perfil da empresafalse
pagesstringAplicar em
all Todas as páginas · first Só na primeira
"all"
fitstringConteúdo do documento
shrink Encaixar nas margens · over Manter como está
"shrink"
topnumberMargem do cabeçalho (mm)
Usada só em algumas combinações de opções.
35
bottomnumberMargem do rodapé (mm)
Usada só em algumas combinações de opções.
25

Arquivos extras

Com arquivo por URL (JSON)

curl -X POST "https://convertaja.com.br/v1/tools/papel-timbrado" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"files":[{"url":"https://seusite.com.br/arquivos/exemplo1.pdf"}],"options":{"pages":"first","fit":"over"},"webhook_url":"https://seusite.com.br/webhooks/convertaja"}'

Resposta

202 com a tarefa (ou 200 já concluída, com ?wait=true). Baixe em outputs[].url ou em download_url (ZIP quando há vários arquivos). Os arquivos ficam disponíveis por 1 hora. Se a tarefa falhar, os crédito volta para o seu saldo.

{
  "id": "V1StGXR8_Z5j",
  "tool": "papel-timbrado",
  "status": "running",
  "progress": 0,
  "credits_charged": 1,
  "outputs": []
}

Prefere sem programar? Use Aplicar papel timbrado no site.

Outras ferramentas de Escritório e negócios