API dla deweloperów
Automatyzuj przetwarzanie PDF za pomocą prostego żądania HTTP — te same potoki, które zasilają witrynę.
Szybki start
Utwórz klucz API w swoim panelu sterowania, w sekcji API dla deweloperów. Następnie wyślij plik z kluczem w nagłówku X-Api-Key:
curl -X POST https://makeitpdf.com/api/v1/compress/ \
-H "X-Api-Key: mip_your_key_here" \
-F "file=@document.pdf"Odpowiedź zawiera linki do pobrania przetworzonych plików:
{
"success": true,
"tool": "compress",
"files": ["https://makeitpdf.com/media/temp/…/document_compressed.pdf"],
"credits_remaining": 18
}Punkty końcowe
Wszystkie punkty końcowe akceptują POST z multipart/form-data. Dołącz pliki w polu file (powtórz dla wielu plików). Lista czytelna maszynowo znajduje się pod adresem /api/v1/tools/.
| Punkt końcowy | Wejście | Dodatkowe pola |
|---|---|---|
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 |
Przykład: przetłumacz PDF na niemiecki
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"Cennik i limity
Żądania API wykorzystują ten sam limit co Twoje konto na stronie: najpierw dzienne zadania i miesięczne kwoty AI Twojego planu, następnie Twoje kredyty (1 kredyt za standardowe zadanie, 5 za dokument AI). Nie ma oddzielnej subskrypcji API.
- Konto Free: 5 zadań/dzień, aby wypróbować API – karta nie jest wymagana.
- Pakiety kredytów: 5 USD za 20 kredytów, nigdy nie wygasają – przewidywalne płatności za użycie.
- Subskrypcje Pro i Business zwiększają dzienne limity zadań, rozmiaru plików i stron dla każdego wywołania API.
- Limit żądań: 60 żądań na minutę na klucz. Pliki wynikowe są przechowywane zgodnie z oknem retencji Twojego planu.
Błędy
Błędy zwracają obiekt JSON z kodem błędu i czytelną dla człowieka wiadomością:
{ "success": false, "error": "daily_limit_reached",
"message": "Daily task limit reached for your plan…", "credits_remaining": 0 }| Status | Znaczenie |
|---|---|
| 400 | Brakujący plik lub wymagane pole – wiadomość wskazuje nazwę |
| 401 | Brakujący, nieznany lub odwołany klucz API |
| 403 | Osiągnięto limit planu lub kredytów – kod błędu wskazuje limit |
| 422 | Nie udało się przetworzyć pliku |
| 429 | Przekroczono limit żądań – spróbuj ponownie po minucie |
| 500 | Nieoczekiwany błąd serwera – spróbuj ponownie, a następnie skontaktuj się z nami |
API jest w fazie beta. Pytania lub potrzebujesz udostępnienia narzędzia?
Skontaktuj się z nami