Để xuất PDF từ HTML trong một ứng dụng, bạn thường phải tự thiết lập bước render, nạp font và hình ảnh, kiểm tra phân trang, rồi xử lý yêu cầu và lưu file kết quả. Khi tích hợp vào sản phẩm, bạn còn cần theo dõi lần render nào đã xong, lần nào thất bại và người dùng lấy file ở đâu.
Tembuilder là nền tảng render HTML/CSS thành PDF, cung cấp quy trình này qua ứng dụng web và API. Bạn chuẩn bị nội dung HTML/CSS trong một template, truyền dữ liệu JSON khi tạo tài liệu và nhận file PDF sau khi render hoàn tất.
Template quản lý cách trình bày; dữ liệu JSON cung cấp nội dung thay đổi ở mỗi lần render. Bạn có thể cập nhật thiết kế mà không phải đưa toàn bộ HTML/CSS vào mã nguồn của phần mềm gọi API.
Cách hoạt động
- Tạo template HTML/CSS. Viết và chỉnh bố cục trong editor, import template hoặc dùng một mẫu từ Marketplace. Khai báo các trường dữ liệu mà template cần nhận.
- Kiểm tra và publish. Lưu thiết kế, xem dữ liệu Default trong PDF preview, kiểm tra font, hình ảnh và ngắt trang, rồi publish phiên bản cần sử dụng.
- Render và lấy PDF. Gửi yêu cầu với template, phiên bản và dữ liệu JSON qua API hoặc Run. Theo dõi trạng thái và tải file khi render thành công.
HTML/CSS được lưu trong template. Khi gọi Render API, bạn tham chiếu template đó và gửi dữ liệu cho lần render, thay vì gửi trực tiếp một trang HTML bất kỳ.
Quản lý template
Trong ứng dụng web, bạn có thể:
- Chỉnh HTML/CSS, font, ảnh, khổ giấy, lề, header và footer.
- Khai báo parameters để đưa dữ liệu JSON vào nội dung tài liệu.
- Quản lý version, lịch sử chỉnh sửa và các variant của template.
- Xem trước PDF, thử render trong Run và tra cứu kết quả trong Renders.
Xem cách các thành phần kết hợp để tạo PDF trong bài Làm quen với concept của Tembuilder. Cách sử dụng editor nằm trong bài Làm quen với trình soạn thảo.
Tích hợp API
Phần mềm của bạn gửi yêu cầu render bằng API key của project. Tembuilder tiếp nhận yêu cầu và xử lý theo job; response ban đầu chưa chứa file PDF hoàn chỉnh.
Bạn có thể theo dõi trạng thái qua API hoặc nhận thông báo webhook. Khi job thành công, tải PDF để lưu vào hệ thống hoặc cung cấp cho người dùng. Xem Render API reference.
Ví dụ sử dụng
Bạn có thể render báo cáo từ dữ liệu của hệ thống, tạo chứng chỉ cho từng người nhận hoặc xuất báo giá theo thông tin đơn hàng. Đây là các trường hợp sử dụng cùng một quy trình HTML/CSS → PDF; nội dung và cách trình bày do template của bạn quyết định.
Bắt đầu
- Tạo PDF đầu tiên: thử quy trình bằng một template mẫu trong ứng dụng.
- Render API reference: tích hợp render vào phần mềm.
- Kết nối AI qua MCP: cho AI đọc và hỗ trợ chỉnh template trong project.