PDFVela — pdfvela.com
เครื่องมือ PDF ทั้งหมด

วิธีส่งไฟล์ PDF เข้า API แบบ Base64

API ใบกำกับภาษีอิเล็กทรอนิกส์ ลายเซ็นอิเล็กทรอนิกส์ หรือระบบขนส่ง ต้องการให้ส่งเอกสารมาในช่อง JSON นี่คือวิธีแปลง PDF เป็นข้อความที่ถูกรูปแบบ ตรวจสอบ และเลี่ยงข้อผิดพลาดที่ทำให้คำขอล้มเหลว

โดย · อัปเดตเมื่อ 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

คำถามเกี่ยวกับการส่ง PDF แบบ Base64

ทำไม API ถึงต้องการ Base64 แทนตัวไฟล์?

JSON รับได้แค่ข้อความ Base64 เขียนไบต์ของ PDF ด้วยตัวอักษร ตัวเลข + และ / เอกสารทั้งฉบับจึงใส่ลงในช่องข้อความช่องเดียวได้ คู่กับข้อมูลอื่น เช่น หมายเลขลูกค้าหรือวันที่ในใบแจ้งหนี้

ต้องส่งคำนำหน้า data:application/pdf;base64, ไปด้วยไหม?

ส่วนใหญ่ไม่ต้อง API ส่วนมากต้องการเฉพาะโค้ดที่ขึ้นต้นด้วย JVBERi0 ให้ส่ง data URI เฉพาะเมื่อเอกสารประกอบ API แสดงไว้ หรือเมื่อเบราว์เซอร์ต้องใช้เป็น URL เช่น ใน iframe

API แจ้งว่า Base64 ไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุดคืออะไร?

มีการขึ้นบรรทัดใหม่หรือมีคำนำหน้าอยู่ในข้อความ หรือโค้ดถูกตัดขาดตอนวาง ให้ใช้โค้ดล้วนในบรรทัดเดียว และตรวจว่าส่วนท้ายของข้อความส่งไปถึงครบ

PDF ใหญ่ได้แค่ไหน?

ขึ้นอยู่กับแต่ละบริการ แต่ข้อความ Base64 จะใหญ่กว่าไฟล์ราวหนึ่งในสาม PDF ขนาด 3 MB จึงกลายเป็น JSON ประมาณ 4 MB API จำนวนมากรับได้ไม่เกินไม่กี่เมกะไบต์ วิธีแก้ที่ง่ายที่สุดคือบีบอัด PDF ก่อน

Base64 เป็นการเข้ารหัสลับหรือเปล่า?

ไม่ใช่ ใครก็ตามที่มีโค้ดนี้แปลงกลับเป็นเอกสารได้ ส่งผ่าน HTTPS เท่านั้น และอย่าวาง PDF ที่เป็นความลับลงในเว็บไซต์ที่อัปโหลดไฟล์