API PDF
Mulai sekarang

API PDF Macaaw

API PDF untuk mengompres, mengonversi, dan menandatangani

Satu REST API untuk 20 alat PDF dan tanda tangan elektronik. Setiap tugas berjalan di server kami di London dan file dihapus dalam 2 jam.

Dapatkan kunci sandbox gratisBaca dokumentasi API

  • OpenAPI 3.1
  • Koleksi Postman
  • Sandbox gratis
  • Webhook bertanda tangan
Kompres PDF dengan satu permintaan
Bahasa contoh kode
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"}
  • 20alat PDF dalam satu endpoint
  • 1 panggilanuntuk mengunggah dan memulai tugas
  • < 2 hhingga file Anda dihapus
  • £0untuk sandbox

Yang dapat Anda bangun

Tugas PDF yang tidak perlu ditangani sendiri oleh produk Anda

  • Kecilkan unggahan sebelum disimpan

    Kompres PDF, atau sesuaikan dengan ukuran tertentu, begitu pengguna Anda mengunggahnya.

  • Konversi file Office ke PDF

    Word, Excel, PowerPoint, OpenDocument, dan HTML ke PDF, dengan tata letak yang tetap terjaga.

  • Buat pindaian dapat dicari

    Pembacaan teks dalam 27 bahasa, PDF/A untuk arsip, dan tabel langsung ke Excel.

  • Kirim perjanjian dari aplikasi Anda sendiri

    Buat dokumen dari PDF, tempatkan kolom dengan tag teks, kirim, dan unduh salinan bertanda tangan.

  • Sematkan penandatanganan di produk Anda

    Buka sesi penandatanganan di dalam situs Anda, terbatas pada origin yang Anda izinkan.

  • Jalankan batch dengan webhook

    Mulai ratusan tugas dan dapatkan callback bertanda tangan saat masing-masing selesai.

Cara kerjanya

Dari kunci hingga hasil dalam empat panggilan

  1. Buat kunci

    Buat kunci sandbox di akun Anda. Beralih ke kunci live saat Anda siap.

    Akun › Developer
  2. Mulai tugas

    Kirim file dan alat dalam satu permintaan multipart.

    POST /public/v1/tasks
  3. Dapatkan kabar saat selesai

    Berlangganan task_completed, atau polling tugasnya.

    webhook: task_completed
  4. Unduh

    Ambil hasilnya, lalu hapus atau biarkan kedaluwarsa.

    GET /tasks/{id}/download

Endpoint

API yang kecil dan mudah diprediksi

URL dasar https://macaaw.com/public/v1 · JSON dengan kunci snake_case · Authorization: API-Key …

Referensi API lengkap

Tugas · alat PDF

  • GET/toolsSetiap alat yang dapat Anda panggil, beserta opsinya
  • POST/tasksUnggah file dan mulai alat dalam satu panggilan
  • GET/tasks/{id}Status: queued, processing, completed, atau failed
  • GET/tasks/{id}/downloadFile hasil, atau ZIP
  • DELETE/tasks/{id}Hapus file sekarang

Dokumen · tanda tangan elektronik

  • POST/documentsPDF beserta penerima dan kolom, atau tag teks
  • POST/documents/{id}/sendKirim lewat email, atau secara senyap untuk penandatanganan tersemat
  • GET/documents/{id}/detailsPenerima, kolom, dan linimasa lengkap
  • POST/documents/{id}/sessionTautan penandatanganan untuk halaman Anda sendiri
  • GET/documents/{id}/downloadPDF bertanda tangan beserta sertifikatnya

Webhook

  • POST/webhook-subscriptionsPilih pemicu seperti task_completed atau document_state_changed
  • GET/webhook-eventsRiwayat pengiriman, dengan kirim ulang

Keamanan

Dibuat untuk produksi sejak hari pertama

Aturan penghapusan dan pemrosesan di Inggris yang sama seperti situs web, ditambah kontrol yang diharapkan tim engineering.

  • Kunci yang Anda kendalikanKunci live dan sandbox, ditampilkan sekali dan disimpan sebagai hash. Cabut kunci mana pun dari akun Anda.
  • Webhook bertanda tanganSetiap pengiriman menyertakan ?signature= berisi HMAC-SHA256 dari isi permintaan, dibuat dengan kunci bersama Anda.
  • File dihapus dengan cepatFile tugas disimpan 1 jam di akun gratis dan 2 jam di Pro dan Business, lalu hilang. DELETE menghapusnya seketika.
  • Pemrosesan di InggrisSetiap tugas berjalan di server kami di London. Log permintaan tidak pernah menyimpan isi file atau nama file.
  • Batas laju yang adil120 tugas baru per menit per pengguna, dengan Retry-After pada setiap 429.
  • Percobaan ulang yang amanKirim Idempotency-Key dan permintaan berulang mengembalikan hasil pertama selama 24 jam.

Harga

Mulai gratis. Bayar seiring Anda berkembang.

Sandbox

£0

  • Setiap endpoint, dengan data uji
  • 10 permintaan per menit
  • Hingga 5 halaman per tugas
  • Keluaran diberi stempel “Sandbox”
  • Data uji dihapus setelah 7 hari
Dapatkan kunci sandbox

Live, di Pro atau Business

Mulai £4,99per bulan, ditagih tahunan

  • Memakai kuota bulanan paket Anda
  • Lalu kredit: mulai £5 untuk 500
  • 1 kredit per halaman OCR, 2 kredit per konversi Office
  • 120 tugas baru per menit
Bandingkan paket

Enterprise

Harga volume

  • Harga volume untuk halaman dan konversi
  • Batas khusus, dijual berdasarkan kontrak
  • Penagihan faktur tahunan
  • Kontak khusus
Hubungi kami

Pertanyaan

Pertanyaan dari developer

Apakah ada cara gratis untuk mencoba API?

Ya. Setiap pengguna yang masuk dapat membuat kunci sandbox secara gratis. Panggilan sandbox dibatasi 10 per menit dan 5 halaman per tugas, setiap keluaran diberi stempel “Sandbox”, dan data uji dihapus setelah 7 hari.

Alat mana yang dapat saya panggil?

20 alat yang berjalan di server kami, dari Kompres dan OCR hingga konversi Office dan PDF/A, plus tanda tangan elektronik. GET /tools mencantumkannya beserta opsinya. 20 alat browser berjalan di browser pengguna Anda, jadi tidak ada di API v1.

Bagaimana penggunaan API ditagih?

Kunci live disertakan di Pro dan Business. Panggilan memakai kuota bulanan yang sama dengan situs web; selebihnya berlaku kredit. Paket kredit mulai dari £5 untuk 500 kredit dan berlaku 12 bulan.

Apakah Anda memiliki SDK?

Dokumentasi menyediakan contoh salin-tempel dalam curl, Node, dan Python untuk setiap endpoint, file OpenAPI 3.1, dan koleksi Postman, sehingga Anda dapat membuat klien dalam bahasa apa pun.

Apa yang terjadi jika endpoint webhook saya sedang mati?

Kami mencoba lagi tiga kali, setelah 1 menit, 10 menit, dan 1 jam, lalu menandai pengiriman sebagai gagal. Anda dapat mengirim ulang dari akun Anda atau dengan API.

Rilis fitur PDF minggu ini.

Buat kunci sandbox dalam semenit. Tanpa kartu.