من أين تأتي ملفات PDF بصيغة Base64؟
تكتب صيغة Base64 أي ملف باستخدام الحروف والأرقام وبضعة رموز فقط، فيمكنه الانتقال داخل النصوص. ولهذا كثيرًا ما تصلك ملفات PDF على شكل نص طويل بدلًا من ملف:
- استجابات API. خدمات الفواتير الإلكترونية وملصقات الشحن وإيصالات الدفع والتوقيع الإلكتروني تُرجع عادةً ملف PDF كحقل Base64 داخل JSON أو XML.
- نماذج الويب وقواعد البيانات. بعض الأنظمة تخزّن المستندات المرفوعة في عمود نصي، فيعطيك التصدير الرمز لا الملف.
- مصدر البريد الإلكتروني. في المصدر الخام لرسالة البريد الإلكتروني، تظهر المرفقات ككتل Base64 تحت رأس Content-Transfer-Encoding: base64.
- اختبارات المطورين. عندما ينتج الكود الخاص بك ملف PDF بصيغة Base64، فهذه طريقة سريعة للتأكد من أن النتيجة هي المستند الذي توقعته.
يشرح دليل كيفية حفظ نص Base64 كملف PDF خطوة بخطوة أين تجد الرمز وكيف تنسخه كاملًا. وللمهمة نفسها مع الصور، راجع Base64 إلى صورة. وللاتجاه المعاكس، أي الحصول على رمز ملف PDF، استخدم PDF إلى Base64.
كيف تعرف ما بداخل الرمز
| يبدأ الرمز بـ | ما هو | أين تذهب |
|---|---|---|
| JVBERi0 | مستند PDF | هذه الصفحة |
| data:application/pdf;base64, | مستند PDF (Data URI) | هذه الصفحة |
| iVBORw0KGgo | صورة PNG | Base64 إلى صورة |
| /9j/ | صورة فوتوغرافية JPG | Base64 إلى صورة |
| UEsDB | ملف ZIP أو Word (.docx) أو Excel (.xlsx) | ليس ملف PDF |
إذا واجهتك مشكلة
«هذا ليس رمز Base64 صالحًا.» اختلط بالرمز نص آخر، أو توقف النسخ في المنتصف. حدّد القيمة كاملة بين علامتي التنصيص والصقها مرة أخرى.
«محتواه ليس ملف PDF.» ربما نسخت حقلًا مجاورًا، كاسم ملف أو معرّف أو قيمة تجزئة للتوقيع. ابحث عن القيمة التي تبدأ بـ JVBERi0.
يُفتح ملف PDF لكن بعض صفحاته فارغة. نهاية الرمز مفقودة: فُك ترميز الصفحات الأولى، أما الباقي فلم يكن موجودًا. انسخ الرمز مرة أخرى كاملًا، وفي ملفات JSON الطويلة يكون استخدام خيار «نسخ القيمة» في عارض JSON أكثر أمانًا من التحديد اليدوي.
يطلب ملف PDF كلمة مرور. كان المستند محميًا قبل ترميزه. وإذا كنت تعرف كلمة المرور، يمكنك إزالتها باستخدام إزالة كلمة مرور PDF.