เมื่อไหร่ที่ต้องใช้ PDF แบบ Base64?
JSON, XML และแบบฟอร์มหลายแบบรับได้แค่ข้อความ ไฟล์ไบนารีอย่าง PDF จึงต้องเขียนเป็นข้อความก่อน และ Base64 คือวิธีที่นิยมใช้กัน
- ส่งเอกสารไปยัง API บริการใบกำกับภาษีอิเล็กทรอนิกส์ ลายเซ็นอิเล็กทรอนิกส์ ขนส่ง และระบบจัดการเอกสารมักขอ PDF ในฟิลด์ชื่อ content, file หรือ data
- ทดสอบการเชื่อมต่อระบบของคุณเอง ตัวเลือก JSON ให้ request body สำเร็จรูปสำหรับวางใน Postman, curl หรือ unit test โดยไม่ต้องเขียนโค้ดเข้ารหัสเอง
- เก็บในคอลัมน์ข้อความหรือไฟล์ตั้งค่า บางระบบเก็บเทมเพลตหรือใบรับรองขนาดเล็กเป็นข้อความ Base64 ช่วยให้ใส่ PDF ลงไปได้
- ฝังในหน้าเว็บ data URI ช่วยให้หน้าเว็บแสดง PDF ใน iframe ได้โดยไม่ต้องโฮสต์ไฟล์แยก เหมาะกับเอกสารขนาดเล็ก
ตัวอย่างคำขอทีละขั้นตอนด้วย curl, JavaScript และ Python อยู่ในวิธีส่ง PDF ไปยัง API แบบ Base64 หากต้องการแปลงโค้ดกลับเป็นไฟล์ ใช้แปลง Base64 เป็น PDF ส่วนรูปภาพ ดูแปลงรูปภาพเป็น Base64
หน้าตาของแต่ละรูปแบบ
| รูปแบบ | ขึ้นต้นด้วย | การใช้งานทั่วไป |
|---|---|---|
| เฉพาะโค้ด Base64 | JVBERi0 | ฟิลด์ API, JSON, XML, ฐานข้อมูล |
| Data URI | data:application/pdf;base64, | แท็บเบราว์เซอร์ iframe แท็ก object |
| บรรทัดละ 76 ตัวอักษร | JVBERi0 แบ่งเป็นบรรทัดสั้น ๆ | ไฟล์แนบอีเมล (MIME) ไฟล์แบบ PEM |
| JSON | { "fileName": … } | request body สำหรับทดสอบการเชื่อมต่อระบบ |
หากเกิดปัญหา
"ไฟล์นี้ไม่ใช่ PDF ที่ถูกต้อง" ไฟล์ไม่ได้ขึ้นต้นด้วยส่วนหัว %PDF- ตามที่ไฟล์ PDF ควรเป็น อาจเป็นไฟล์ Word หรือรูปภาพที่ถูกเปลี่ยนชื่อเป็น .pdf ลองเปิดในโปรแกรมอ่าน PDF ก่อน หรือแปลงด้วยเครื่องมือที่ถูกต้อง
API แจ้งว่าเนื้อหาไม่ถูกต้อง ตรวจว่าคุณส่งโค้ดล้วนที่ไม่มีคำนำหน้า data: และไม่มีการขึ้นบรรทัดใหม่ เว้นแต่เอกสารของ API จะกำหนดไว้ และตรวจด้วยว่าตอนวางไม่มีส่วนท้ายขาดหายไป
ข้อความยาวเกินกว่าที่ฟิลด์รับได้ ลดขนาด PDF ด้วยบีบอัด PDF แล้วแปลงอีกครั้ง โค้ดจะสั้นลงในสัดส่วนเดียวกัน