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.
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"}'import { openAsBlob } from 'node:fs';
const form = new FormData();
form.append('files', await openAsBlob('arquivo1.pdf'), 'arquivo1.pdf');
form.append('letterhead', await openAsBlob('letterhead.pdf'), 'letterhead.pdf');
form.append('options', JSON.stringify({"pages":"first","fit":"over"}));
const res = await fetch('https://convertaja.com.br/v1/tools/papel-timbrado?wait=true', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.CONVERTAJA_KEY}` },
body: form,
});
const job = await res.json();
console.log(job.status, job.outputs);import json, os, requests
res = requests.post(
"https://convertaja.com.br/v1/tools/papel-timbrado",
params={"wait": "true"},
headers={"Authorization": f"Bearer {os.environ['CONVERTAJA_KEY']}"},
files=[("files", open("arquivo1.pdf", "rb")), ("letterhead", open("letterhead.pdf", "rb"))],
data={"options": json.dumps({"pages": "first", "fit": "over"})},
)
job = res.json()
print(job["status"], job.get("outputs"))<?php
$ch = curl_init('https://convertaja.com.br/v1/tools/papel-timbrado?wait=true');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('CONVERTAJA_KEY')],
CURLOPT_POSTFIELDS => [
'files[0]' => new CURLFile('arquivo1.pdf'),
'letterhead' => new CURLFile('letterhead.pdf'),
'options' => json_encode(['pages' => 'first', 'fit' => 'over']),
],
]);
$job = json_decode(curl_exec($ch), true);
echo $job['status'];
Opções
Envie em options (JSON) ou como campos do formulário. Opções desconhecidas são recusadas com 400 invalid_option.
| Opção | Tipo | Descrição e valores | Padrão |
|---|---|---|---|
useSavedLetterhead | boolean | Usar o papel timbrado salvo no perfil da empresa | false |
pages | string | Aplicar emall Todas as páginas · first Só na primeira | "all" |
fit | string | Conteúdo do documentoshrink Encaixar nas margens · over Manter como está | "shrink" |
top | number | Margem do cabeçalho (mm) Usada só em algumas combinações de opções. | 35 |
bottom | number | Margem do rodapé (mm) Usada só em algumas combinações de opções. | 25 |
Arquivos extras
letterhead— Papel timbrado (PDF ou imagem do tamanho da folha) (pdf, png, jpg, jpeg), obrigatório. No JSON, envie emextra_files.letterhead.
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.