Macaaw PDF API
PDF API สำหรับบีบอัด แปลง และลงนาม
REST API เดียวสำหรับเครื่องมือ PDF 22 รายการและลายเซ็นอิเล็กทรอนิกส์ ทุกงานทำงานบนเซิร์ฟเวอร์ของเราในลอนดอน และไฟล์จะถูกลบภายใน 2 ชั่วโมง
รับคีย์แซนด์บ็อกซ์ฟรีอ่านเอกสาร API
- OpenAPI 3.1
- คอลเลกชัน Postman
- แซนด์บ็อกซ์ฟรี
- เว็บฮุกที่ลงนาม
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"}- 22เครื่องมือ PDF ในเอ็นด์พอยต์เดียว
- 1 การเรียกเพื่ออัปโหลดและเริ่มงาน
- < 2 hจนกว่าไฟล์ของคุณจะถูกลบ
- £0สำหรับแซนด์บ็อกซ์
สิ่งที่คุณสร้างได้
งาน PDF ที่ผลิตภัณฑ์ของคุณไม่ต้องดูแลเอง
ลดขนาดไฟล์ที่อัปโหลดก่อนจัดเก็บ
บีบอัด PDF หรือทำให้ไม่เกินขนาดที่กำหนด ทันทีที่ผู้ใช้อัปโหลด
แปลงไฟล์ Office เป็น PDF
Word, Excel, PowerPoint, OpenDocument และ HTML เป็น PDF โดยเลย์เอาต์ไม่เพี้ยน
ทำให้ไฟล์สแกนค้นหาได้
การจดจำข้อความใน 32 ภาษา PDF/A สำหรับเก็บถาวร และตารางตรงไปยัง Excel
ส่งข้อตกลงจากแอปของคุณเอง
สร้างเอกสารจาก PDF วางช่องด้วยแท็กข้อความ ส่ง และดาวน์โหลดสำเนาที่ลงนามแล้ว
ฝังการลงนามในผลิตภัณฑ์ของคุณ
เปิดเซสชันลงนามภายในเว็บไซต์ของคุณ จำกัดเฉพาะต้นทางที่คุณอนุญาต
ประมวลผลเป็นชุดด้วยเว็บฮุก
เริ่มงานหลายร้อยรายการ และรับการเรียกกลับที่ลงนามแล้วเมื่อแต่ละงานเสร็จ
คีย์แบบกำหนดขอบเขตและงานแบบชุด
คีย์ที่กำหนดขอบเขตและหมุนเวียนได้ งานแบบชุด ความคืบหน้าแบบสด และการเรนเดอร์หน้า
ตัวแก้ไขแบบฝัง
ใส่ตัวแก้ไข PDF หรือตัวแก้ไขรูปภาพไว้ในแอปของคุณเอง เคียงข้างการลงนามแบบฝัง
วิธีการทำงาน
จากคีย์ถึงผลลัพธ์ในสี่การเรียก
สร้างคีย์
สร้างคีย์แซนด์บ็อกซ์ในบัญชีของคุณ เปลี่ยนเป็นคีย์จริงเมื่อพร้อม
บัญชี › นักพัฒนาเริ่มงาน
ส่งไฟล์และเครื่องมือในคำขอ multipart เดียว
POST /public/v1/tasksรับแจ้งเมื่อเสร็จ
สมัครรับ task_completed หรือโพลงาน
webhook: task_completedดาวน์โหลด
ดึงผลลัพธ์ แล้วลบหรือปล่อยให้หมดอายุ
GET /tasks/{id}/download
เอ็นด์พอยต์
API ขนาดเล็กที่คาดเดาได้
Base URL https://macaaw.com/public/v1 · JSON ที่ใช้คีย์แบบ snake_case · Authorization: API-Key …
งาน · เครื่องมือ PDF
- GET
/toolsทุกเครื่องมือที่เรียกได้ พร้อมตัวเลือก - POST
/tasksอัปโหลดไฟล์และเริ่มเครื่องมือในการเรียกเดียว - GET
/tasks/{id}สถานะ: queued, processing, completed หรือ failed - GET
/tasks/{id}/downloadไฟล์ผลลัพธ์ หรือ ZIP - DELETE
/tasks/{id}ลบไฟล์ทันที
เอกสาร · ลายเซ็นอิเล็กทรอนิกส์
- POST
/documentsPDF พร้อมผู้รับและช่องข้อมูล หรือแท็กข้อความ - POST
/documents/{id}/sendส่งทางอีเมล หรือแบบเงียบสำหรับการลงนามแบบฝัง - GET
/documents/{id}/detailsผู้รับ ช่องข้อมูล และไทม์ไลน์ทั้งหมด - POST
/documents/{id}/sessionลิงก์ลงนามสำหรับหน้าของคุณเอง - GET
/documents/{id}/downloadPDF ที่ลงนามพร้อมใบรับรอง
เว็บฮุก
- POST
/webhook-subscriptionsเลือกทริกเกอร์ เช่น task_completed หรือ document_state_changed - GET
/webhook-eventsประวัติการส่ง พร้อมส่งใหม่
ความปลอดภัย
สร้างมาเพื่อใช้งานจริงตั้งแต่วันแรก
กฎการลบและการประมวลผลในสหราชอาณาจักรเหมือนเว็บไซต์ พร้อมการควบคุมที่ทีมวิศวกรรมคาดหวัง
- คีย์ที่คุณควบคุมคีย์จริงและคีย์แซนด์บ็อกซ์แสดงครั้งเดียวและเก็บเป็นแฮช เพิกถอนคีย์ใดก็ได้จากบัญชีของคุณ
- เว็บฮุกที่ลงนามการส่งแต่ละครั้งมี ?signature= ซึ่งเป็น HMAC-SHA256 ของเนื้อหา สร้างด้วยคีย์ที่ใช้ร่วมกัน
- ลบไฟล์อย่างรวดเร็วไฟล์งานเก็บไว้ 1 ชั่วโมงในบัญชีฟรี และ 2 ชั่วโมงใน Pro และ Business จากนั้นจะหายไป DELETE จะลบทันที
- ประมวลผลในสหราชอาณาจักรทุกงานทำงานบนเซิร์ฟเวอร์ของเราในลอนดอน บันทึกคำขอไม่เก็บเนื้อหาหรือชื่อไฟล์
- ขีดจำกัดอัตราที่เป็นธรรมงานใหม่ 120 รายการต่อนาทีต่อผู้ใช้ พร้อม Retry-After ในทุก 429
- ลองใหม่อย่างปลอดภัยส่ง Idempotency-Key แล้วคำขอที่ซ้ำจะได้ผลลัพธ์แรกเป็นเวลา 24 ชั่วโมง
ราคา
เริ่มฟรี จ่ายตามการเติบโต
แซนด์บ็อกซ์
£0
- ทุกเอ็นด์พอยต์ พร้อมข้อมูลทดสอบ
- 10 คำขอต่อนาที
- สูงสุด 5 หน้าต่องาน
- ผลลัพธ์ประทับ “Sandbox”
- ลบข้อมูลทดสอบหลัง 7 วัน
คีย์จริง บน Pro หรือ Business
เริ่มต้น £4.99ต่อเดือน เรียกเก็บรายปี
- ใช้โควตารายเดือนของแพ็กเกจคุณ
- จากนั้นใช้เครดิต: เริ่มต้น £5 สำหรับ 500
- 1 เครดิตต่อหน้า OCR, 2 เครดิตต่อการแปลงไฟล์ Office
- งานใหม่ 120 รายการต่อนาที
Enterprise
ราคาตามปริมาณ
- ราคาตามปริมาณสำหรับหน้าและการแปลงไฟล์
- ขีดจำกัดแบบกำหนดเอง ขายตามสัญญา
- เรียกเก็บเงินด้วยใบแจ้งหนี้รายปี
- ผู้ติดต่อเฉพาะ
คำถาม
คำถามจากนักพัฒนา
มีวิธีทดลองใช้ API ฟรีหรือไม่
มี ผู้ใช้ที่ลงชื่อเข้าใช้ทุกคนสร้างคีย์แซนด์บ็อกซ์ได้ฟรี การเรียกแซนด์บ็อกซ์จำกัดที่ 10 ต่อนาทีและ 5 หน้าต่องาน ทุกผลลัพธ์จะประทับคำว่า “Sandbox” และข้อมูลทดสอบจะถูกลบหลัง 7 วัน
เรียกใช้เครื่องมือใดได้บ้าง
เครื่องมือ 22 รายการที่ทำงานบนเซิร์ฟเวอร์ของเรา ตั้งแต่ บีบอัด และ OCR ไปจนถึงการแปลงไฟล์ Office และ PDF/A รวมถึงลายเซ็นอิเล็กทรอนิกส์ GET /tools แสดงรายการพร้อมตัวเลือก เครื่องมือเบราว์เซอร์ 33 รายการทำงานในเบราว์เซอร์ของผู้ใช้ จึงไม่อยู่ใน API v1
คิดค่าใช้ API อย่างไร
คีย์จริงมาพร้อม Pro และ Business การเรียกใช้โควตารายเดือนเดียวกับเว็บไซต์ เมื่อเกินจะใช้เครดิต แพ็กเครดิตเริ่มต้นที่ £5 สำหรับ 500 เครดิต และใช้ได้ 12 เดือน
มี SDK หรือไม่
เอกสารมีตัวอย่างพร้อมคัดลอกใน curl, Node และ Python สำหรับทุกเอ็นด์พอยต์ ไฟล์ OpenAPI 3.1 และคอลเลกชัน Postman คุณจึงสร้างไคลเอนต์ในภาษาใดก็ได้
จะเกิดอะไรขึ้นหากเอ็นด์พอยต์เว็บฮุกของฉันล่ม
เราลองอีกสามครั้ง หลัง 1 นาที 10 นาที และ 1 ชั่วโมง แล้วจึงทำเครื่องหมายว่าการส่งล้มเหลว คุณส่งใหม่ได้จากบัญชีหรือด้วย API
ส่งมอบฟีเจอร์ PDF ภายในสัปดาห์นี้
สร้างคีย์แซนด์บ็อกซ์ได้ในหนึ่งนาที ไม่ต้องใช้บัตร