PDF API

Macaaw PDF API

PDF API สำหรับบีบอัด แปลง และลงนาม

REST API เดียวสำหรับเครื่องมือ PDF 22 รายการและลายเซ็นอิเล็กทรอนิกส์ ทุกงานทำงานบนเซิร์ฟเวอร์ของเราในลอนดอน และไฟล์จะถูกลบภายใน 2 ชั่วโมง

รับคีย์แซนด์บ็อกซ์ฟรีอ่านเอกสาร API

  • OpenAPI 3.1
  • คอลเลกชัน Postman
  • แซนด์บ็อกซ์ฟรี
  • เว็บฮุกที่ลงนาม
บีบอัด PDF ด้วยคำขอเดียว
ภาษาของตัวอย่างโค้ด
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 หรือตัวแก้ไขรูปภาพไว้ในแอปของคุณเอง เคียงข้างการลงนามแบบฝัง

วิธีการทำงาน

จากคีย์ถึงผลลัพธ์ในสี่การเรียก

  1. สร้างคีย์

    สร้างคีย์แซนด์บ็อกซ์ในบัญชีของคุณ เปลี่ยนเป็นคีย์จริงเมื่อพร้อม

    บัญชี › นักพัฒนา
  2. เริ่มงาน

    ส่งไฟล์และเครื่องมือในคำขอ multipart เดียว

    POST /public/v1/tasks
  3. รับแจ้งเมื่อเสร็จ

    สมัครรับ task_completed หรือโพลงาน

    webhook: task_completed
  4. ดาวน์โหลด

    ดึงผลลัพธ์ แล้วลบหรือปล่อยให้หมดอายุ

    GET /tasks/{id}/download

เอ็นด์พอยต์

API ขนาดเล็กที่คาดเดาได้

Base URL https://macaaw.com/public/v1 · JSON ที่ใช้คีย์แบบ snake_case · Authorization: API-Key …

ข้อมูลอ้างอิง API ฉบับเต็ม

งาน · เครื่องมือ 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 ภายในสัปดาห์นี้

สร้างคีย์แซนด์บ็อกซ์ได้ในหนึ่งนาที ไม่ต้องใช้บัตร