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
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
Buat kunci
Buat kunci sandbox di akun Anda. Beralih ke kunci live saat Anda siap.
Akun › DeveloperMulai tugas
Kirim file dan alat dalam satu permintaan multipart.
POST /public/v1/tasksDapatkan kabar saat selesai
Berlangganan task_completed, atau polling tugasnya.
webhook: task_completedUnduh
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 …
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
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
Enterprise
Harga volume
- Harga volume untuk halaman dan konversi
- Batas khusus, dijual berdasarkan kontrak
- Penagihan faktur tahunan
- Kontak khusus
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.