PDF API
Bắt đầu miễn phí

Macaaw PDF API

PDF API để nén, chuyển đổi và ký

Một REST API cho 20 công cụ PDF và chữ ký điện tử. Mọi tác vụ chạy trên máy chủ của chúng tôi tại London và tệp được xóa trong vòng 2 giờ.

Nhận khóa sandbox miễn phíĐọc tài liệu API

  • OpenAPI 3.1
  • Bộ sưu tập Postman
  • Sandbox miễn phí
  • Webhook có chữ ký
Nén một tệp PDF chỉ với một yêu cầu
Ngôn ngữ của mã mẫu
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"}
  • 20công cụ PDF trên một endpoint
  • 1 lệnh gọiđể tải lên và khởi chạy một tác vụ
  • < 2 hcho đến khi tệp của bạn bị xóa
  • 0 £cho sandbox

Bạn có thể xây dựng gì

Những công việc PDF mà sản phẩm của bạn không nên tự đảm nhận

  • Thu nhỏ tệp tải lên trước khi lưu trữ

    Nén PDF, hoặc điều chỉnh cho vừa một kích thước chính xác, ngay khi người dùng của bạn tải lên.

  • Chuyển tệp Office sang PDF

    Word, Excel, PowerPoint, OpenDocument và HTML sang PDF, giữ nguyên bố cục.

  • Làm cho bản quét có thể tìm kiếm

    Nhận dạng văn bản bằng 27 ngôn ngữ, PDF/A để lưu trữ, và chuyển bảng thẳng sang Excel.

  • Gửi thỏa thuận từ ứng dụng của riêng bạn

    Tạo tài liệu từ một tệp PDF, đặt các trường bằng thẻ văn bản, gửi đi và tải bản đã ký.

  • Nhúng việc ký vào sản phẩm của bạn

    Mở một phiên ký ngay trong trang web của bạn, giới hạn ở các nguồn gốc (origin) mà bạn cho phép.

  • Chạy hàng loạt với webhook

    Khởi chạy hàng trăm tác vụ và nhận lệnh gọi lại có chữ ký khi từng tác vụ hoàn tất.

Cách hoạt động

Từ khóa đến kết quả trong bốn lệnh gọi

  1. Tạo khóa

    Tạo khóa sandbox trong tài khoản của bạn. Chuyển sang khóa live khi bạn sẵn sàng.

    Tài khoản › Nhà phát triển
  2. Khởi chạy tác vụ

    Gửi các tệp và công cụ trong một yêu cầu multipart.

    POST /public/v1/tasks
  3. Biết khi nào xong

    Đăng ký task_completed, hoặc thăm dò tác vụ.

    webhook: task_completed
  4. Tải về

    Lấy kết quả, rồi xóa hoặc để nó tự hết hạn.

    GET /tasks/{id}/download

Endpoint

Một API nhỏ gọn, dễ đoán

URL gốc https://macaaw.com/public/v1 · JSON với khóa snake_case · Authorization: API-Key …

Tài liệu tham chiếu API đầy đủ

Tác vụ · công cụ PDF

  • GET/toolsMọi công cụ bạn có thể gọi, kèm các tùy chọn
  • POST/tasksTải tệp lên và khởi chạy công cụ trong một lệnh gọi
  • GET/tasks/{id}Trạng thái: queued, processing, completed hoặc failed
  • GET/tasks/{id}/downloadTệp kết quả, hoặc một tệp ZIP
  • DELETE/tasks/{id}Xóa các tệp ngay

Tài liệu · chữ ký điện tử

  • POST/documentsMột tệp PDF cùng người nhận và các trường, hoặc thẻ văn bản
  • POST/documents/{id}/sendGửi qua email, hoặc gửi ngầm để ký nhúng
  • GET/documents/{id}/detailsNgười nhận, các trường và toàn bộ dòng thời gian
  • POST/documents/{id}/sessionMột liên kết ký cho trang của riêng bạn
  • GET/documents/{id}/downloadTệp PDF đã ký cùng chứng nhận của nó

Webhook

  • POST/webhook-subscriptionsChọn các trigger như task_completed hoặc document_state_changed
  • GET/webhook-eventsLịch sử gửi, có thể gửi lại

Bảo mật

Được xây dựng cho môi trường production ngay từ ngày đầu

Cùng quy tắc xóa tệp và xử lý tại Vương quốc Anh như trên trang web, cộng với các công cụ kiểm soát mà một đội kỹ thuật mong đợi.

  • Khóa do bạn kiểm soátKhóa live và sandbox, chỉ hiển thị một lần và được lưu dưới dạng hash. Thu hồi bất kỳ khóa nào từ tài khoản của bạn.
  • Webhook có chữ kýMỗi lần gửi kèm ?signature= là HMAC-SHA256 của nội dung, tạo bằng khóa chia sẻ của bạn.
  • Tệp được xóa nhanhTệp của tác vụ được giữ 1 giờ với tài khoản miễn phí và 2 giờ với Pro và Business, sau đó chúng biến mất. DELETE xóa chúng ngay lập tức.
  • Xử lý tại Vương quốc AnhMọi tác vụ chạy trên máy chủ của chúng tôi tại London. Nhật ký yêu cầu không bao giờ lưu nội dung hay tên tệp.
  • Giới hạn tốc độ hợp lý120 tác vụ mới mỗi phút cho mỗi người dùng, kèm Retry-After trên mọi phản hồi 429.
  • Thử lại an toànGửi Idempotency-Key và một yêu cầu lặp lại sẽ trả về kết quả đầu tiên trong 24 giờ.

Bảng giá

Bắt đầu miễn phí. Trả phí khi bạn lớn mạnh.

Sandbox

0 £

  • Mọi endpoint, với dữ liệu thử nghiệm
  • 10 yêu cầu mỗi phút
  • Tối đa 5 trang mỗi tác vụ
  • Kết quả được đóng dấu “Sandbox”
  • Dữ liệu thử nghiệm bị xóa sau 7 ngày
Nhận khóa sandbox

Live, trên Pro hoặc Business

Từ 4,99 £mỗi tháng, thanh toán theo năm

  • Dùng hạn mức hằng tháng của gói của bạn
  • Sau đó dùng tín dụng: từ 5 £ cho 500
  • 1 tín dụng mỗi trang OCR, 2 tín dụng mỗi lượt chuyển đổi Office
  • 120 tác vụ mới mỗi phút
So sánh các gói

Enterprise

Giá theo khối lượng

  • Giá theo khối lượng cho số trang và lượt chuyển đổi
  • Giới hạn tùy chỉnh, bán theo hợp đồng
  • Thanh toán hóa đơn theo năm
  • Một đầu mối liên hệ riêng
Liên hệ với chúng tôi

Câu hỏi

Nhà phát triển thường hỏi

Có cách nào dùng thử API miễn phí không?

Có. Bất kỳ người dùng nào đã đăng nhập đều có thể tạo khóa sandbox miễn phí. Các lệnh gọi sandbox bị giới hạn 10 mỗi phút và 5 trang mỗi tác vụ, mọi kết quả đều được đóng dấu “Sandbox”, và dữ liệu thử nghiệm bị xóa sau 7 ngày.

Tôi có thể gọi những công cụ nào?

20 công cụ chạy trên máy chủ của chúng tôi, từ Nén PDF và OCR đến chuyển đổi Office và PDF/A, cùng chữ ký điện tử. GET /tools liệt kê chúng kèm các tùy chọn. 20 công cụ trình duyệt chạy trong trình duyệt của người dùng bạn, nên không có trong API v1.

Việc sử dụng API được tính phí như thế nào?

Khóa live đi kèm Pro và Business. Các lệnh gọi dùng cùng hạn mức hằng tháng như trên trang web; vượt quá đó sẽ dùng tín dụng. Gói tín dụng bắt đầu từ 5 £ cho 500 tín dụng và có hiệu lực 12 tháng.

Bạn có SDK không?

Tài liệu có các mẫu sao chép dán sẵn bằng curl, Node và Python cho mọi endpoint, một tệp OpenAPI 3.1 và một bộ sưu tập Postman, để bạn có thể tạo client bằng bất kỳ ngôn ngữ nào.

Điều gì xảy ra nếu endpoint webhook của tôi ngừng hoạt động?

Chúng tôi thử lại thêm ba lần, sau 1 phút, 10 phút và 1 giờ, rồi đánh dấu lần gửi là thất bại. Bạn có thể gửi lại từ tài khoản của mình hoặc bằng API.

Ra mắt tính năng PDF ngay trong tuần này.

Tạo khóa sandbox trong một phút. Không cần thẻ.