API PDF

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
Skompresuj plik PDF jednym żądaniem
Język przykładowego kodu
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

  1. Utwórz klucz

    Utwórz klucz sandbox na swoim koncie. Gdy wszystko będzie gotowe, przejdź na klucz produkcyjny.

    Konto › Dla deweloperów
  2. Uruchom zadanie

    Wyślij pliki i narzędzie w jednym żądaniu multipart.

    POST /public/v1/tasks
  3. Dowiedz się o zakończeniu

    Zasubskrybuj task_completed lub odpytuj zadanie.

    webhook: task_completed
  4. Pobierz

    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 …

Pełna dokumentacja API

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
Uzyskaj klucz sandbox

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
Porównaj plany

Enterprise

Ceny hurtowe

  • Ceny hurtowe za strony i konwersje
  • Niestandardowe limity w ramach umowy
  • Roczne rozliczenie na fakturę
  • Dedykowany opiekun
Porozmawiaj z nami

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.