Macaaw PDF API
API PDF do kompresji, konwersji i podpisywania
Jedno REST API dla narzędzi PDF (22) i podpisów elektronicznych. Każde zadanie działa na naszych serwerach w Londynie, a pliki są usuwane w ciągu 2 godz.
Uzyskaj bezpłatny klucz sandboxPrzeczytaj dokumentację API
- OpenAPI 3.1
- Kolekcja Postman
- Bezpłatny sandbox
- Podpisane webhooki
curl https://macaaw.com/public/v1/tasks \
-H "Authorization: API-Key $MACAAW_API_KEY" \
-F "files[]=@lease.pdf" \
-F 'data={"tool":"compress-pdf","options":{"level":"recommended"}}'
# 201 Created
{ "id": "…", "tool": "compress-pdf", "status": "task.queued" }// Node 18+ (fetch, FormData and Blob are built in)
import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("files[]", new Blob([await readFile("lease.pdf")]), "lease.pdf");
form.append("data", JSON.stringify({ tool: "compress-pdf", options: { level: "recommended" } }));
const res = await fetch("https://macaaw.com/public/v1/tasks", {
method: "POST",
headers: { Authorization: `API-Key ${process.env.MACAAW_API_KEY}` },
body: form,
});
const task = await res.json(); // { id, tool, status: "task.queued" }# Python 3 with requests
import json, os, requests
res = requests.post(
"https://macaaw.com/public/v1/tasks",
headers={"Authorization": f"API-Key {os.environ['MACAAW_API_KEY']}"},
files={"files[]": open("lease.pdf", "rb")},
data={"data": json.dumps({"tool": "compress-pdf", "options": {"level": "recommended"}})},
)
task = res.json() # {"id": ..., "status": "task.queued"}- 22narzędzia PDF w jednym punkcie końcowym
- 1 wywołanieaby przesłać pliki i uruchomić zadanie
- < 2 hdo usunięcia twoich plików
- 0 GBPza sandbox
Co możesz zbudować
Zadania PDF, którymi twój produkt nie powinien się zajmować
Zmniejszaj przesyłane pliki przed zapisaniem
Kompresuj pliki PDF lub dopasowuj je do dokładnego rozmiaru w chwili, gdy użytkownicy je przesyłają.
Konwertuj pliki Office do PDF
Word, Excel, PowerPoint, OpenDocument i HTML do PDF, z zachowanym układem.
Umożliwiaj wyszukiwanie w skanach
Rozpoznawanie tekstu w 32 językach, PDF/A do archiwów i tabele prosto do Excela.
Wysyłaj umowy z własnej aplikacji
Utwórz dokument z pliku PDF, umieść pola za pomocą znaczników tekstowych, wyślij go i pobierz podpisaną kopię.
Osadź podpisywanie w swoim produkcie
Otwórz sesję podpisywania w swojej witrynie, ograniczoną do dozwolonych źródeł.
Uruchamiaj partie z webhookami
Uruchamiaj setki zadań i otrzymuj podpisane wywołanie zwrotne po zakończeniu każdego z nich.
Klucze z zakresami i zadania wsadowe
Klucze z zakresami i rotacją, zadania wsadowe, postęp na żywo i podglądy stron.
Osadzone edytory
Umieść edytor PDF lub edytor obrazów we własnej aplikacji, obok osadzonego podpisywania.
Jak to działa
Od klucza do wyniku w czterech wywołaniach
Utwórz klucz
Utwórz klucz sandbox na swoim koncie. Gdy wszystko będzie gotowe, przejdź na klucz produkcyjny.
Konto › Dla deweloperówUruchom zadanie
Wyślij pliki i narzędzie w jednym żądaniu multipart.
POST /public/v1/tasksDowiedz się o zakończeniu
Zasubskrybuj task_completed lub odpytuj zadanie.
webhook: task_completedPobierz
Pobierz wynik, a potem go usuń lub pozwól mu wygasnąć.
GET /tasks/{id}/download
Punkty końcowe
Małe, przewidywalne API
Bazowy URL https://macaaw.com/public/v1 · JSON z kluczami w snake_case · Authorization: API-Key …
Zadania · narzędzia PDF
- GET
/toolsKażde narzędzie, które możesz wywołać, wraz z opcjami - POST
/tasksPrześlij pliki i uruchom narzędzie w jednym wywołaniu - GET
/tasks/{id}Status: queued, processing, completed lub failed - GET
/tasks/{id}/downloadPlik wynikowy lub ZIP - DELETE
/tasks/{id}Usuń pliki teraz
Dokumenty · podpisy elektroniczne
- POST
/documentsPlik PDF z odbiorcami i polami lub znacznikami tekstowymi - POST
/documents/{id}/sendWyślij e-mailem lub bez powiadomienia do osadzonego podpisywania - GET
/documents/{id}/detailsOdbiorcy, pola i pełna oś czasu - POST
/documents/{id}/sessionLink do podpisu na twojej stronie - GET
/documents/{id}/downloadPodpisany PDF z certyfikatem
Webhooki
- POST
/webhook-subscriptionsWybierz wyzwalacze, np. task_completed lub document_state_changed - GET
/webhook-eventsHistoria dostarczeń z możliwością ponownego wysłania
Bezpieczeństwo
Gotowe do produkcji od pierwszego dnia
Te same zasady usuwania i przetwarzanie w Wielkiej Brytanii co w witrynie, plus mechanizmy kontroli, jakich oczekuje zespół inżynierów.
- Klucze pod twoją kontroląKlucze produkcyjne i sandbox, pokazywane raz i przechowywane jako skrót. Każdy klucz możesz unieważnić na swoim koncie.
- Podpisane webhookiKażde dostarczenie zawiera ?signature= z HMAC-SHA256 treści, utworzonym twoim kluczem współdzielonym.
- Szybko usuwane plikiPliki zadań są przechowywane przez 1 godzinę na bezpłatnym koncie i 2 godziny w Pro i Business, a potem znikają. DELETE usuwa je od razu.
- Przetwarzanie w Wielkiej BrytaniiKażde zadanie działa na naszych serwerach w Londynie. Logi żądań nigdy nie przechowują zawartości ani nazw plików.
- Uczciwe limity żądańNowe zadania na minutę na użytkownika: 120, z nagłówkiem Retry-After przy każdym 429.
- Bezpieczne ponawianieWyślij Idempotency-Key, a powtórzone żądanie zwróci pierwszy wynik przez 24 godz.
Cennik
Zacznij za darmo. Płać w miarę rozwoju.
Sandbox
0 GBP
- Każdy punkt końcowy z danymi testowymi
- Żądania na minutę: 10
- Maks. liczba stron na zadanie: 5
- Wyniki ze stemplem „Sandbox”
- Dane testowe usuwane po 7 dniach
Produkcyjnie, w Pro lub Business
Od 4,99 GBPmiesięcznie, rozliczane rocznie
- Korzysta z miesięcznych limitów twojego planu
- Następnie kredyty: od 5 GBP za 500
- 1 kredyt za stronę OCR, 2 kredyty za konwersję Office
- Nowe zadania na minutę: 120
Enterprise
Ceny hurtowe
- Ceny hurtowe za strony i konwersje
- Niestandardowe limity w ramach umowy
- Roczne rozliczenie na fakturę
- Dedykowany opiekun
Pytania
Pytania deweloperów
Czy można bezpłatnie wypróbować API?
Tak. Każdy zalogowany użytkownik może bezpłatnie utworzyć klucz sandbox. Wywołania sandbox są ograniczone do 10 na minutę, a maks. liczba stron na zadanie to 5; każdy wynik ma stempel „Sandbox”, a dane testowe są usuwane po 7 dniach.
Które narzędzia mogę wywoływać?
Narzędzia działające na naszych serwerach (22), od kompresji i OCR po konwersje Office i PDF/A, a także podpisy elektroniczne. GET /tools wyświetla je wraz z opcjami. Narzędzia przeglądarkowe (33) działają w przeglądarkach twoich użytkowników, więc nie ma ich w API v1.
Jak rozliczane jest korzystanie z API?
Klucze produkcyjne są dostępne w planach Pro i Business. Wywołania korzystają z tych samych miesięcznych limitów co witryna; powyżej nich obowiązują kredyty. Pakiety kredytów zaczynają się od 5 GBP (kredyty: 500) i są ważne przez 12 mies.
Czy macie SDK?
Dokumentacja zawiera przykłady do skopiowania w curl, Node i Pythonie dla każdego punktu końcowego, plik OpenAPI 3.1 i kolekcję Postman, dzięki czemu można wygenerować klienta w dowolnym języku.
Co się stanie, jeśli mój punkt końcowy webhooka nie działa?
Ponawiamy jeszcze trzy razy, po 1 minucie, 10 minutach i 1 godzinie, a potem oznaczamy dostarczenie jako nieudane. Możesz wysłać je ponownie z konta lub przez API.
Wdróż funkcje PDF jeszcze w tym tygodniu.
Utwórz klucz sandbox w minutę. Karta nie jest wymagana.