Run cho phép bạn gửi dữ liệu và tạo PDF ngay trong editor. Bạn chọn bản mẫu, điền các trường đầu vào rồi xem kết quả trong cùng một nơi — thuận tiện để thử cách mẫu hoạt động trước khi nối vào phần mềm của mình.
1. Chọn key, version và variant
Lưu và publish version muốn chạy, sau đó mở Run. Chọn API key của project có quyền template:render, số Version và tên Variant. Nếu chưa có key, tạo trong API Keys.
Bộ chọn của Run độc lập với phần editor đang mở: bạn có thể chạy v1 trong khi xem v2. Khi đổi Version, Run tải Parameters, Default và Variants của đúng bản đã lưu đó; hãy đợi tải xong rồi nhập dữ liệu. Dữ liệu thử được giữ riêng cho từng version của mẫu trong trình duyệt này. Có thể chọn bản Draft, nhưng cần publish trước khi render.
2. Điền Parameters của lần chạy
Mở phần Parameters trong Run và thay các giá trị cần thử. Các trường được dựng từ cấu trúc đã khai báo ở Schema; object và array vẫn cần giữ đúng kiểu dữ liệu.
Giá trị nhập ở đây dùng cho lần tạo PDF, không sửa Default của mẫu. Thao tác đặt lại dữ liệu lấy lại các giá trị mặc định từ Parameters.
{ "recipient": "Tembuilder", "copies": 2 }3. Tạo PDF và mở kết quả
Bấm Render. Lần chạy xuất hiện trong lịch sử của Run trong lúc hệ thống xử lý. Mở dòng kết quả để xem trạng thái và tải PDF khi thành công.
Run là render thật: lần thành công được tính vào quota và có output lưu trữ. Nếu chỉ đang chỉnh bố cục, dùng preview trong editor.
Khi thất bại, mở chi tiết lỗi của lần chạy để biết cần sửa dữ liệu, mẫu hay điều kiện sử dụng trước khi gửi lại.
4. Lấy mã gọi để bắt đầu tích hợp
Menu sao chép trong Run có cURL, JavaScript và Python. Mã dùng placeholder <YOUR_API_KEY>; bạn cần cung cấp key trong môi trường chạy của mình.
Đoạn mã dùng version, variant và dữ liệu hiện đang chọn trong Run. Hãy chọn đúng bộ dữ liệu muốn tích hợp rồi mới sao chép; thay đổi form sau đó không sửa đoạn mã đã copy trước đó. Để tra field của yêu cầu, status và endpoint tải output, xem Render API reference.