API tạo PDF v1 - Không trạng thái

API tạo PDF
từ các mẫu kinh doanh

Tạo tệp PDF từ các mẫu HTML, DOCX, Markdown hoặc JSON của bạn. Không lưu giữ dữ liệu - không có tài liệu hoặc dữ liệu nào được lưu trữ.

Nhận khóa API của bạn Hướng dẫn bắt đầu nhanh

4 định dạng đầu vào

Thay thế biến

Không lưu trữ dữ liệu

SLA thời gian hoạt động 99,9%

Bắt đầu nhanh

Nhận bản PDF đầu tiên của bạn trong vòng chưa đầy 2 phút. Tạo khóa API, gửi yêu cầu và tải xuống kết quả.

Nhận khóa API của bạn

Tạo khóa API từ bảng điều khiển bên dưới hoặc từ trang tổng quan của bạn.

Khóa API của bạn là bí mật. Không bao giờ để lộ nó trong mã giao diện người dùng.

Gửi yêu cầu đầu tiên của bạn

Sử dụng lệnh cURL sau để tạo tệp PDF:

Terminal

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<h1>Invoice #{{invoice_number}}</h1><p>Client: {{client_name}}</p><p>Amount: {{amount}}</p>",
    "variables": {
      "invoice_number": "2026-001",
      "client_name": "Acme Corp",
      "amount": "$1,250.00"
    }
  }' \
  --output invoice.pdf

Tải xuống bản PDF của bạn

API trả về tệp nhị phân PDF trực tiếp trong nội dung phản hồi.

Tệp PDF được tạo sẽ được lưu vào tệp được chỉ định trong cờ --output.

Bản trình diễn trực tiếp

Hãy thử API ngay tại đây — chỉnh sửa nội dung và biến, sau đó nhấn Tạo để xem bản PDF của bạn ngay lập tức.

Đăng nhập để thử bản demo

Tạo một tài khoản miễn phí để truy cập sân chơi trực tiếp và tạo tối đa 5 bản PDF demo.

Tạo tài khoản Đăng nhập

Bảng điều khiển API

Quản lý khóa API của bạn và theo dõi việc sử dụng trực tiếp từ trang này.

Yêu cầu đăng nhập

Vui lòng đăng nhập để tạo và quản lý khóa API của bạn.

Tạo tài khoản Đăng nhập

Xác thực

Tất cả các yêu cầu API đều yêu cầu khóa API được gửi qua tiêu đề X-API-Key.

Nó hoạt động như thế nào

Tạo khóa API từ bảng điều khiển hoặc trang tổng quan.
Đưa nó vào mọi yêu cầu dưới dạng tiêu đề X-API-Key.
API xác thực khóa của bạn và kiểm tra hạn ngạch của bạn.
Khóa không hợp lệ hoặc bị thu hồi sẽ trả về lỗi 401.

Giữ khóa API của bạn an toàn. Sử dụng các biến môi trường, không bao giờ mã hóa cứng trong mã nguồn.

Yêu cầu mẫu

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"format":"html","content":"<h1>Hello</h1>"}' \
  --output output.pdf

Phản hồi khóa không hợp lệ (401)

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid."
}

Định dạng đầu vào

EasyPDF hỗ trợ 4 định dạng đầu vào. Chọn một trong những phù hợp nhất với quy trình làm việc của bạn.

HTML

Hỗ trợ CSS đầy đủ, hoàn hảo đến từng pixel thông qua Chrome

DOCX

Tải lên các mẫu Word có phần giữ chỗ có thể thay đổi

Markdown

5 chủ đề tích hợp cho tài liệu đẹp

Template JSON

Công cụ canvas để kiểm soát bố cục chính xác

HTML → PDF

Phổ biến nhất

Gửi bất kỳ HTML nào bằng CSS nội tuyến. Công cụ kết xuất Chrome đảm bảo hiển thị trình duyệt phù hợp với đầu ra hoàn hảo đến từng pixel.

Các tính năng chính

Hỗ trợ CSS3 đầy đủ (Flexbox, Grid, truy vấn phương tiện)
Đầu trang và chân trang tùy chỉnh với số trang
Thay thế biến bằng cú pháp {{variable}}
Bố cục đáp ứng với kích thước trang A4/Letter/Pháp lý

Request body

{
  "format": "html",
  "content": "<html><head><style>body{font-family:Arial;padding:40px}h1{color:#333}.total{font-size:24px;font-weight:bold;color:#8b5cf6}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Date: {{date}}</p><p>Client: {{client_name}}</p><table><tr><th>Item</th><th>Price</th></tr><tr><td>{{item_1}}</td><td>{{price_1}}</td></tr></table><p class='total'>Total: {{total}}</p></body></html>",
  "variables": {
    "invoice_number": "2026-042",
    "date": "2026-03-16",
    "client_name": "Acme Corp",
    "item_1": "Web Development",
    "price_1": "$3,500",
    "total": "$4,700"
  },
  "options": { "page_format": "A4", "margin_top": "25mm" }
}

Điểm cuối API

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

Tạo tệp PDF từ nội dung HTML, Markdown hoặc JSON mẫu.

Request Body (JSON)

tham số	Kiểu	Yêu cầu	Sự miêu tả
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	Chuỗi nội dung HTML hoặc Markdown (bắt buộc đối với html/markdown)
`template_data`	`object`	Yes*	Đối tượng JSON mẫu (bắt buộc đối với định dạng mẫu)
`variables`	`object`	No	Cặp khóa-giá trị để thay thế biến
`options`	`object`	No	Tùy chọn tạo PDF (định dạng trang, lề, v.v.)

Phản ứng

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

Tải lên tệp DOCX để chuyển đổi sang PDF với tính năng thay thế biến tùy chọn.

Form Fields

Field	Kiểu	Yêu cầu	Sự miêu tả
`file`	File	Yes	Tệp .docx cần chuyển đổi
`variables`	string (JSON)	No	Cặp khóa-giá trị để thay thế biến
`options`	string (JSON)	No	Tùy chọn PDF dưới dạng chuỗi JSON

POST/generate/previewAPI Key

Tạo bản xem trước PNG của trang đầu tiên thay vì bản PDF đầy đủ.

200Content-Type: image/png

GET/usageAPI Key

Kiểm tra mức sử dụng hàng tháng hiện tại của bạn và hạn ngạch còn lại.

Response (200)

{
  "month": "2026-03",
  "used": 142,
  "limit": 500,
  "remaining": 358,
  "plan": "starter"
}

POST/keysJWT Bearer

Tạo khóa API mới (yêu cầu xác thực JWT).

GET/keysJWT Bearer

Liệt kê tất cả các khóa API của bạn cùng với số liệu thống kê sử dụng.

DELETE/keys/:key_idJWT Bearer

Thu hồi (hủy kích hoạt) khóa API vĩnh viễn.

Ví dụ về mã

Các ví dụ hoàn chỉnh, sẵn sàng để sử dụng bằng ngôn ngữ và định dạng ưa thích của bạn. Chọn ngôn ngữ và định dạng đầu vào bên dưới.

curl — HTML

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<html><head><style>body{font-family:sans-serif;padding:40px}h1{color:#8b5cf6}table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1px solid #eee}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Client: <strong>{{client_name}}</strong></p><table><tr><th>Item</th><th>Amount</th></tr><tr><td>{{line_1}}</td><td>{{amount_1}}</td></tr></table><h2>Total: {{total}}</h2></body></html>",
    "variables": {
      "invoice_number": "INV-2026-042",
      "client_name": "Acme Corp",
      "line_1": "Web Development",
      "amount_1": "$3,500.00",
      "total": "$4,700.00"
    },
    "options": { "page_format": "A4", "margin_top": "20mm" }
  }' --output invoice.pdf

Trường hợp sử dụng

Xem cách các nhóm sử dụng API EasyPDF để tự động tạo tài liệu trên quy mô lớn.

Hóa đơn & Biên lai

Tạo hóa đơn có thương hiệu với các mục hàng động, tổng số và chi tiết khách hàng.

HTML / DOCX

Hợp đồng & Thỏa thuận

Điền dữ liệu khách hàng vào các mẫu Word và chuyển đổi sang PDF để ký.

DOCX

Chứng chỉ & Bằng cấp

Tạo chứng chỉ được cá nhân hóa với bố cục và định vị chính xác.

Template JSON

Báo cáo & Trang tổng quan

Biến dữ liệu Markdown hoặc HTML thành báo cáo PDF tinh tế.

Markdown / HTML

Thư & Gửi thư

Tạo thư được cá nhân hóa từ các mẫu DOCX để gửi thư số lượng lớn.

DOCX

Tài liệu tuân thủ

Tạo ra các tài liệu tuân thủ sẵn sàng cho việc kiểm tra, chống giả mạo.

HTML

Tùy chọn PDF

Tùy chỉnh đầu ra với các tham số tùy chọn này trong đối tượng tùy chọn.

Option	Kiểu	Mặc định	Sự miêu tả
`page_format`	`string`	`"A4"`	Kích thước trang: A4, Letter, Legal, Tabloid hoặc tùy chỉnh
`landscape`	`boolean`	`false`	Bật hướng ngang
`margin_top`	`string`	`"20mm"`	Lề trên (đơn vị CSS: mm, cm, in, px)
`margin_bottom`	`string`	`"20mm"`	Lề dưới
`margin_left`	`string`	`"15mm"`	Lề trái
`margin_right`	`string`	`"15mm"`	Lề phải
`header_html`	`string`	`null`	Nội dung HTML cho tiêu đề trang
`footer_html`	`string`	`null`	Nội dung HTML cho chân trang (hỗ trợ pageNumber, TotalPages)
`theme`	`string`	`"modern"`	Chủ đề Markdown: hiện đại, cổ điển, tối giản, github, học thuật

Ví dụ về tùy chọn đầy đủ

JSON

{
  "format": "html",
  "content": "<h1>Report</h1><p>Content here...</p>",
  "variables": {},
  "options": {
    "page_format": "A4",
    "landscape": false,
    "margin_top": "25mm",
    "margin_bottom": "25mm",
    "margin_left": "20mm",
    "margin_right": "20mm",
    "header_html": "<div style='text-align:right;font-size:9px'>Acme Corp — Confidential</div>",
    "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
    "theme": "modern"
  }
}

Xử lý lỗi

API trả về các lỗi JSON có cấu trúc với mã lỗi nhất quán.

Định dạng phản hồi lỗi

{
  "error": "missing_content",
  "message": "The 'content' field is required for html format."
}

HTTP	Error	Khi	phải làm gì
`400`	`missing_content`	Thiếu trường bắt buộc	Kiểm tra các trường nội dung yêu cầu
`400`	`invalid_json`	Phân tích cú pháp JSON không thành công	Xác thực tải trọng JSON của bạn
`400`	`unsupported_format`	Giá trị định dạng không xác định	Sử dụng html, markdown hoặc mẫu
`401`	`invalid_api_key`	Không tìm thấy khóa API	Xác minh tiêu đề X-API-Key của bạn
`402`	`quota_exceeded`	Đã vượt quá hạn ngạch hàng tháng	Nâng cấp gói của bạn hoặc đợi thiết lập lại
`403`	`api_key_revoked`	Chìa khóa đã bị thu hồi	Tạo khóa API mới
`429`	`rate_limit_exceeded`	Đã đạt đến giới hạn tỷ lệ	Đợi và thử lại với thời gian chờ theo cấp số nhân
`500`	`generation_failed`	Lỗi xử lý nội bộ	Kiểm tra lỗi nội dung của bạn và thử lại

Giới hạn tỷ lệ & hạn ngạch

Mỗi gói có hạn ngạch PDF hàng tháng và giới hạn tốc độ mỗi phút.

Giới hạn tỷ lệ

Các yêu cầu vượt quá giới hạn tốc độ của bạn sẽ nhận được phản hồi 429 với tiêu đề Thử lại sau.

Phản hồi giới hạn tỷ lệ

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

Hạn ngạch hàng tháng

Việc sử dụng sẽ được đặt lại vào ngày đầu tiên hàng tháng vào lúc nửa đêm UTC.

Plan	PDFs/tháng	Rate limit	Giá	Quá tuổi
Starter	500	10/min	9€/tháng	0,02€/PDF
Business	5 000	30/min	79€/tháng	0,01€/PDF
Enterprise	Phong tục	Phong tục	Theo báo giá	Có thể thương lượng

Thực tiễn tốt nhất

Hãy làm theo những đề xuất này để tận dụng tối đa API.

Sử dụng các biến cho nội dung động

Giữ mẫu của bạn ở trạng thái tĩnh và đưa dữ liệu vào đối tượng biến. Điều này hiệu quả hơn việc xây dựng lại HTML sau mỗi cuộc gọi.

Xử lý lỗi một cách khéo léo

Luôn kiểm tra mã trạng thái HTTP. Triển khai thử lại với thời gian chờ theo cấp số nhân đối với lỗi 429 và 5xx.

Tối ưu hóa mẫu của bạn

Giảm thiểu CSS, tránh các nội dung bên ngoài (nội tuyến chúng) và kiểm tra các mẫu trước khi triển khai vào sản xuất.

Giám sát việc sử dụng của bạn

Sử dụng điểm cuối /usage hoặc bảng điều khiển ở trên để theo dõi mức tiêu thụ và tránh các giới hạn hạn ngạch không mong muốn.

Bảo mật khóa API của bạn

Lưu trữ khóa trong các biến môi trường hoặc trình quản lý bí mật. Xoay chìa khóa định kỳ và thu hồi những cái không sử dụng.

Định giá

Giá cả đơn giản, minh bạch. Chỉ trả tiền cho những gì bạn sử dụng.

Starter

9€/tháng

~0,018€ / PDF

500 PDFs / tháng
10 yêu cầu/phút
Tất cả 4 định dạng đầu vào
Tạo bản xem trước PNG
Hỗ trợ qua email
Quá tuổi : 0,02€/PDF

Bắt đầu

Giá trị tốt nhất

Business

79€/tháng

~0,016€ / PDF

5 000 PDFs / tháng
30 yêu cầu/phút
Tất cả các tính năng của Starter
Hỗ trợ ưu tiên
Bảng điều khiển phân tích sử dụng
Quá tuổi : 0,01€/PDF