วิธีส่งไฟล์ PDF เข้า API แบบ Base64
API ใบกำกับภาษีอิเล็กทรอนิกส์ ลายเซ็นอิเล็กทรอนิกส์ หรือระบบขนส่ง ต้องการให้ส่งเอกสารมาในช่อง JSON นี่คือวิธีแปลง PDF เป็นข้อความที่ถูกรูปแบบ ตรวจสอบ และเลี่ยงข้อผิดพลาดที่ทำให้คำขอล้มเหลว
โดย Metin Ersoy · อัปเดตเมื่อ 10 พฤศจิกายน 2569
API มักต้องการอะไร
API ด้านเอกสารส่วนใหญ่กำหนดให้ส่งข้อมูลเป็น JSON ที่มีช่องชื่อ content, file, data หรือ document ค่าในช่องนั้นคือโค้ด Base64 ของ PDF และมักมีชื่อไฟล์กับประเภทไฟล์อยู่ด้วย เช่น
{
"fileName": "invoice-1024.pdf",
"mimeType": "application/pdf",
"content": "JVBERi0xLjcKJ..."
}
ก่อนเริ่มเขียนโค้ด ให้หาข้อมูล 3 อย่างในเอกสารประกอบ API ได้แก่ ชื่อช่อง ต้องมีคำนำหน้า data: หรือไม่ (ส่วนใหญ่ไม่ต้อง) และขนาดสูงสุดที่รับได้
1. แปลง PDF เป็น Base64
วิธีที่เร็วที่สุดในการได้ค่าไว้ทดสอบคือ แปลง PDF เป็น Base64 เลือกไฟล์ PDF เลือก เฉพาะโค้ด Base64 แล้วคัดลอกผลลัพธ์ ถ้าอยากได้เนื้อหาคำขอ (request body) ทั้งชุดไว้เป็นจุดเริ่มต้น ให้เลือก JSON แทน ระบบจะใส่ชื่อไฟล์และประเภทไฟล์ให้เอง PDF ถูกแปลงในเบราว์เซอร์ของคุณและไม่ถูกอัปโหลด ข้อนี้สำคัญมากเมื่อเอกสารที่ใช้ทดสอบเป็นใบแจ้งหนี้จริง
ตรวจผลลัพธ์ให้ดี โค้ดควรขึ้นต้นด้วย JVBERi0 ไม่มีช่องว่าง และนอกจากเครื่องหมาย = หนึ่งหรือสองตัวที่ท้ายสุดแล้ว ต้องมีแค่ตัวอักษร ตัวเลข + และ / เท่านั้น
2. ส่งจากโค้ดของคุณ
ขั้นตอนเดียวกันใน 3 รูปแบบที่นิยมใช้ ทุกตัวอย่างจะอ่านไฟล์ เข้ารหัสเป็น Base64 แล้วส่ง JSON ออกไป
# curl (Linux / macOS): base64 -w 0 keeps it on one line
curl -X POST https://api.example.com/documents \
-H "Content-Type: application/json" \
-d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 with requests
import base64, requests
with open("invoice.pdf", "rb") as f:
content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
json={"fileName": "invoice.pdf", "content": content})
บน macOS ให้ใช้ base64 -i invoice.pdf แทน -w 0 ในคำสั่ง curl ส่วนที่อยู่และชื่อช่องในตัวอย่างเป็นเพียงตัวอย่าง ให้ใช้ตามเอกสารประกอบของบริการที่คุณเชื่อมต่อ
3. ตรวจว่าไฟล์ไปและกลับครบถ้วน
ถ้าบริการส่งเอกสารหรือสำเนาที่จัดเก็บไว้กลับมาเป็น Base64 ให้วางคำตอบนั้นลงใน แปลง Base64 เป็น PDF การได้เห็นหน้าแรกและจำนวนหน้าคือวิธีพิสูจน์ที่เร็วที่สุดว่าไม่มีอะไรหายไประหว่างทาง ขั้นตอนโดยละเอียดของการแปลงย้อนกลับอยู่ใน วิธีบันทึกข้อความ Base64 เป็นไฟล์ PDF
ข้อผิดพลาดที่พบบ่อย
| อาการ | สาเหตุที่เป็นไปได้ | วิธีแก้ |
|---|---|---|
| "Invalid Base64" | มีการขึ้นบรรทัดใหม่ (บรรทัดละ 76 ตัวอักษร) หรือมีคำนำหน้า data: | ส่งโค้ดล้วนในบรรทัดเดียว |
| "Payload too large" (413) | PDF ใหญ่เกินไปหลังเข้ารหัส | ลดขนาดด้วย บีบอัด PDF |
| PDF เปิดแล้วว่างเปล่าหรือเสีย | ข้อความถูกตัดขาด | เข้ารหัสใหม่แล้วส่งค่าทั้งหมด |
| ชื่อไฟล์ภาษาไทยหรืออักขระพิเศษแสดงผลเพี้ยน | ส่งชื่อไฟล์ด้วยการเข้ารหัสอักขระที่ผิด | ใช้ UTF-8 กับเนื้อหา JSON |
พร้อมลองใช้หรือยัง ใช้ได้ฟรี และไฟล์ของคุณอยู่ในอุปกรณ์ของคุณเท่านั้น
เปิดเครื่องมือ แปลง PDF เป็น Base64