API do Desenvolvedor

Automatize o processamento de PDF com uma simples solicitação HTTP — os mesmos pipelines que alimentam o site.

Início rápido

Crie uma chave de API em seu painel, em API do Desenvolvedor. Em seguida, envie um arquivo com a chave no cabeçalho X-Api-Key:

curl -X POST https://makeitpdf.com/api/v1/compress/ \
  -H "X-Api-Key: mip_your_key_here" \
  -F "file=@document.pdf"

A resposta contém links de download para os arquivos processados:

{
  "success": true,
  "tool": "compress",
  "files": ["https://makeitpdf.com/media/temp/…/document_compressed.pdf"],
  "credits_remaining": 18
}

Endpoints

Todos os endpoints aceitam POST com multipart/form-data. Anexe arquivos no campo 'file' (repita para múltiplos arquivos). Uma lista legível por máquina está em /api/v1/tools/.

Endpoint	Entrada	Campos extras
`POST /api/v1/merge/`	PDF files (2+)	—
`POST /api/v1/rotate/`	PDF files; rotation: 90\|180\|270 (default 90)	rotation
`POST /api/v1/extract-pages/`	One PDF; pages: e.g. "1-3,5"	pages
`POST /api/v1/compress/`	PDF files; compression_level: low\|recommended\|high	compression_level
`POST /api/v1/repair/`	One PDF	—
`POST /api/v1/flatten/`	One PDF	—
`POST /api/v1/grayscale/`	One PDF	—
`POST /api/v1/word-to-pdf/`	Word documents (.doc/.docx)	—
`POST /api/v1/excel-to-pdf/`	Excel workbooks (.xls/.xlsx)	—
`POST /api/v1/powerpoint-to-pdf/`	PowerPoint files (.ppt/.pptx)	—
`POST /api/v1/image-to-pdf/`	Images (JPG/PNG/WebP…); merge_images: true\|false	page_size, page_orientation, page_margin, merge_images
`POST /api/v1/pdf-to-word/`	PDF files	—
`POST /api/v1/pdf-to-excel/`	PDF files	—
`POST /api/v1/pdf-to-powerpoint/`	PDF files	—
`POST /api/v1/pdf-to-jpg/`	PDF files; image_quality: normal\|high	conversion_type, image_quality
`POST /api/v1/pdf-to-text/`	One PDF	—
`POST /api/v1/pdf-to-pdfa/`	PDF files	pdfa_conformance
`POST /api/v1/ocr/`	Scanned PDFs; ocr_language: eng\|deu\|fra\|… (default eng)	ocr_language, ocr_quality
`POST /api/v1/protect/`	PDF files; password required	password
`POST /api/v1/unlock/`	PDF files; password required	password
`POST /api/v1/translate/`	One PDF; target_language required (e.g. "de"), source_language optional (default auto)	target_language, source_language

Exemplo: traduzir um PDF para alemão

curl -X POST https://makeitpdf.com/api/v1/translate/ \
  -H "X-Api-Key: mip_your_key_here" \
  -F "file=@report.pdf" \
  -F "target_language=de"

Preços e limites

As solicitações da API usam a mesma permissão da sua conta no site: primeiro as tarefas diárias e as cotas mensais de IA do seu plano, depois seus créditos (1 crédito por tarefa padrão, 5 por documento de IA). Não há assinatura de API separada.

Conta Free: 5 tarefas/dia para experimentar a API — não é necessário cartão.
Pacotes de créditos: $5 por 20 créditos, nunca expiram — pagamento por uso previsível.
As assinaturas Pro e Business aumentam os limites diários de tarefas, tamanho de arquivo e páginas para cada chamada de API.
Limite de taxa: 60 solicitações por minuto por chave. Os arquivos de resultado seguem a janela de retenção do seu plano.

Ver planos e pacotes de créditos →

Erros

Os erros retornam um corpo JSON com um código de erro e uma mensagem legível por humanos:

{ "success": false, "error": "daily_limit_reached",
  "message": "Daily task limit reached for your plan…", "credits_remaining": 0 }

Estado	Significado
400	Arquivo ou campo obrigatório ausente — a mensagem o nomeia
401	Chave de API ausente, desconhecida ou revogada
403	Limite do plano ou de crédito atingido — o código de erro nomeia o limite
422	O arquivo não pôde ser processado
429	Limite de taxa excedido — tente novamente após um minuto
500	Erro inesperado do servidor — tente novamente, depois entre em contato conosco

A API está em beta. Perguntas ou uma ferramenta que você precisa exposta?