Tài liệu
Lấy PDF
GET/generations/{id}/pdf
PDF của tài liệu, được kết xuất một lần trên máy chủ của chúng tôi, dưới dạng URL tải về có thời hạn ngắn. Nếu chưa có gì được lưu, lời gọi sẽ kết xuất theo yêu cầu và trả lời khi xong, thường trong vài giây; nếu đã có một lần kết xuất đang chạy ở nơi khác, nó trả về 202 và bạn hỏi lại sau giây lát.
Tham số
| Tên | Kiểu | Mô tả |
|---|---|---|
idbắt buộc | uuid | Id của tài liệu. |
download | 1 | Biến URL thành tệp đính kèm mang tên tài liệu. |
redirect | 1 | Trả về 302 tới URL thay vì JSON. |
Yêu cầu
curl "https://usepaperclerk.com/api/v1/generations/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b/pdf?download=1" \
-H "Authorization: Bearer pc_YOUR_TOKEN"Phản hồi
JSON
{
"status": "ready",
"url": "https://…/generation-pdfs/…/9b8e2f10-5c4d-4e3f-8a7b-6c5d4e3f2a1b.pdf?token=…",
"pages": 2,
"expires_in": 60
}- URL ngừng hoạt động sau expires_in giây. Hãy yêu cầu URL mới thay vì lưu lại.
- Kết xuất thất bại trả về 500 với pdf_render_failed; yêu cầu lại sẽ thử lại.