HTML to PDF API
แปลง HTML หรือ URL เป็น PDF ด้วยคำสั่งเดียว
ส่ง HTML หรือ URL ได้ไฟล์ PDF กลับมาทันที ใช้กับใบเสร็จ ใบเสนอราคา รายงาน และแดชบอร์ด รองรับตัวอักษรไทย
curl -X POST https://YOUR_HOST/v1/pdf \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"html":"<h1>ใบเสร็จรับเงิน</h1><p>ยอดชำระ 1,500 บาท</p>","format":"A4"}' \
--output invoice.pdfทำไมต้องเลือกเรา
ออกแบบมาให้ใช้ใน production
จ่ายเฉพาะงานที่สำเร็จ
นับโควตาหลังสร้าง PDF สำเร็จเท่านั้น คำขอที่ผิดพลาดหรือ render ล้มเหลวจะไม่ถูกหักโควตา
ไม่เก็บไฟล์ของคุณ
ระบบไม่บันทึก HTML หรือ PDF ของคุณลงฐานข้อมูล เก็บเฉพาะจำนวนครั้งที่ใช้งานต่อเดือน แฮชของคีย์ รหัสอ้างอิงการชำระเงินจาก Stripe และอีเมลกับ IP ตอนขอคีย์ทดลอง
รองรับภาษาไทย
ทดสอบแล้วกับฟอนต์ Sarabun ตัวอักษร สระ และวรรณยุกต์ไทยแสดงถูกต้องในไฟล์ PDF แนะนำให้ใส่ฟอนต์ไทยจาก Google Fonts ใน HTML ของคุณเพื่อให้แสดงผลสม่ำเสมอ
API reference
เอกสารการเรียกใช้งาน
การยืนยันตัวตน
ส่งคีย์ใน header Authorization: Bearer lk_... หรือ x-api-key: lk_... ทุกคำขอ
POST /v1/pdf
ส่ง JSON แล้วได้ไฟล์ PDF (application/pdf) กลับมา ต้องใส่ Content-Type: application/json
| พารามิเตอร์ | ประเภท | ค่าเริ่มต้น | รายละเอียด |
|---|---|---|---|
html | string | - | HTML ที่ต้องการแปลง ต้องส่ง html หรือ url อย่างใดอย่างหนึ่งเท่านั้น |
url | string | - | หน้าเว็บ http(s) ที่ให้เบราว์เซอร์เปิดแล้วพิมพ์เป็น PDF |
format | string | A4 | A0-A6, Letter, Legal, Tabloid, Ledger (ไม่สนตัวพิมพ์เล็กใหญ่) |
landscape | boolean | false | true = กระดาษแนวนอน |
printBackground | boolean | true | พิมพ์สีและภาพพื้นหลัง |
preferCSSPageSize | boolean | false | ใช้ขนาดหน้าจาก CSS @page |
scale | number | 1 | 0.1 ถึง 2 |
margin | object | - | ระบุ top, right, bottom, left เป็น string เช่น "10mm" |
pageRanges | string | - | เช่น "1-3" |
headerTemplate, footerTemplate | string | - | HTML ของหัว/ท้ายกระดาษ (ใส่อย่างใดอย่างหนึ่งจะเปิดใช้งานทั้งคู่) |
waitUntil | string | load | load, domcontentloaded หรือ networkidle (timeout 30 วินาที) |
viewport | object | - | ขนาดหน้าจอเบราว์เซอร์ก่อนพิมพ์ เช่น {"width":1280,"height":800} (200 ถึง 3840 px) ใช้กับ URL ที่เลย์เอาต์ขึ้นกับความกว้างหน้าจอ |
css | string | - | CSS ที่ฉีดเข้าหน้าก่อนพิมพ์ (สูงสุด 100,000 ตัวอักษร) เช่น ปิด animation ของหน้าเว็บ |
emulateMediaType | string | - | screen หรือ print เลือก media type ที่ใช้ตอนเรนเดอร์ |
waitForTimeout | number | 0 | รอ (มิลลิวินาที) หลังโหลดหน้าเสร็จ 0 ถึง 10000 สำหรับหน้าที่มี animation |
ตัวอย่างโค้ด
curl -X POST https://YOUR_HOST/v1/pdf \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"html":"<h1>สวัสดี</h1>","format":"A4"}' \
--output out.pdf
const res = await fetch("https://YOUR_HOST/v1/pdf", {
method: "POST",
headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ html: "<h1>สวัสดี</h1>", format: "A4" }),
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
require("fs").writeFileSync("out.pdf", Buffer.from(await res.arrayBuffer()));
import requests
r = requests.post("https://YOUR_HOST/v1/pdf",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"html": "<h1>สวัสดี</h1>", "format": "A4"})
r.raise_for_status()
open("out.pdf", "wb").write(r.content)Response header: x-leafkiln-used (จำนวนไฟล์ที่ใช้ในเดือนนี้) และ x-leafkiln-limit (โควตาต่อเดือน)
GET /v1/usage
ดูแพ็กเกจและโควตาของคีย์ ไม่นับเป็นการใช้งาน
{ "plan": "free", "used": 2, "limit": 100, "remaining": 98 }รหัส error
| HTTP | code | ความหมายและวิธีแก้ |
|---|---|---|
| 400 | bad_request | JSON หรือพารามิเตอร์ไม่ถูกต้อง อ่านข้อความใน error.message |
| 401 | unauthorized | ไม่มีคีย์ หรือคีย์ผิด/ถูกยกเลิก |
| 402 | quota_exceeded | ใช้ครบโควตาเดือนนี้ รีเซ็ตต้นเดือน (UTC) หรืออัปเกรดแพ็กเกจ |
| 413 | too_large | Body เกิน 6 MB |
| 422 / 502 | render_failed | สร้าง PDF ไม่สำเร็จ ตรวจ HTML/URL แล้วลองใหม่ ไม่ถูกหักโควตา |
| 503 | capacity | ระบบ render เต็มชั่วคราว รอสักครู่แล้วลองใหม่ |
Interactive sandbox
ทดลองยิง API ในหน้านี้
Pricing
แพ็กเกจรายเดือน
ชำระเงินเสร็จแล้วรับคีย์ทันทีในหน้าถัดไป
เริ่มต้นใช้งาน
ขอคีย์ทดลองฟรี 100 ไฟล์/เดือน
คีย์จะแสดงครั้งเดียว กรุณาคัดลอกเก็บไว้ที่ปลอดภัย ถ้าหายสามารถขอคีย์ใหม่ทางอีเมลได้