API per sviluppatori
Automatizza l'elaborazione PDF con una semplice richiesta HTTP — le stesse pipeline che alimentano il sito.
Guida rapida
Crea una chiave API nella tua dashboard, sotto API per sviluppatori. Quindi invia un file con la chiave nell'intestazione X-Api-Key:
curl -X POST https://makeitpdf.com/api/v1/compress/ \
-H "X-Api-Key: mip_your_key_here" \
-F "file=@document.pdf"La risposta contiene i link per il download dei file elaborati:
{
"success": true,
"tool": "compress",
"files": ["https://makeitpdf.com/media/temp/…/document_compressed.pdf"],
"credits_remaining": 18
}Endpoint
Tutti gli endpoint accettano POST con multipart/form-data. Allega i file nel campo file (ripetilo per più file). Un elenco leggibile dalla macchina si trova su /api/v1/tools/.
| Endpoint | Input | Campi extra |
|---|---|---|
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 |
Esempio: tradurre un PDF in tedesco
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"Prezzi e limiti
Le richieste API utilizzano la stessa quota del tuo account sul sito web: prima le attività giornaliere e le quote AI mensili del tuo piano, poi i tuoi crediti (1 credito per attività standard, 5 per documento AI). Non esiste un abbonamento API separato.
- Account Free: 5 attività/giorno per provare l'API — nessuna carta richiesta.
- Pacchetti di crediti: 5 $ per 20 crediti, mai in scadenza — pay-as-you-go prevedibile.
- Gli abbonamenti Pro e Business aumentano i limiti di attività giornaliere, dimensioni dei file e pagine per ogni chiamata API.
- Limite di frequenza: 60 richieste al minuto per chiave. I file risultanti seguono la finestra di conservazione del tuo piano.
Errori
Gli errori restituiscono un corpo JSON con un codice di errore e un messaggio leggibile dall'uomo:
{ "success": false, "error": "daily_limit_reached",
"message": "Daily task limit reached for your plan…", "credits_remaining": 0 }| Stato | Significato |
|---|---|
| 400 | File o campo obbligatorio mancante — il messaggio lo indica |
| 401 | Chiave API mancante, sconosciuta o revocata |
| 403 | Limite del piano o dei crediti raggiunto — il codice di errore indica il limite |
| 422 | Il file non può essere elaborato |
| 429 | Limite di frequenza superato — riprova dopo un minuto |
| 500 | Errore imprevisto del server — riprova, quindi contattaci |
L'API è in beta. Domande o uno strumento che ti serve esposto?
Contattaci