كيفية حفظ نص Base64 كملف PDF
استجابة API أو ملف XML لفاتورة أو المصدر الخام لرسالة بريد يحتوي على كتلة نص طويلة تبدأ بالأحرف JVBERi0، وتحتاج إلى المستند الذي بداخلها. إليك الطريقة، من العثور على الكود حتى فتح الملف.
بقلم Metin Ersoy · تاريخ التحديث: 10 نوفمبر 2026
ما ملف PDF بترميز Base64، ولماذا يصل على شكل نص؟
يكتب ترميز Base64 الملف باستخدام الحروف والأرقام وبضعة رموز فقط. وهذا ما يسمح للصيغ النصية، مثل JSON وXML والبريد الإلكتروني، بأن تحمل ملف PDF في داخلها. يحتفظ الكود بنسخة مطابقة تمامًا من المستند، فإذا فككت ترميزه استعدت الملف الأصلي بايتًا بايتًا، وتبقى أي توقيعات رقمية فيه صالحة.
ستصادفه عادةً في هذه المواضع:
- واجهات برمجة الفوترة والمحاسبة. كثيرًا ما تعيد منصات الفوترة الإلكترونية وبرامج المحاسبة نسخة PDF من الفاتورة في حقل بترميز Base64. ويمكن لملفات XML المنظمة للفواتير (مثل UBL) أن تضمّن نسخة PDF القابلة للطباعة بالطريقة نفسها.
- الشحن. عند إنشاء شحنة، تعيد شركات الشحن غالبًا ملصق الشحن كملف PDF بترميز Base64.
- المدفوعات والبنوك. قد تعيد خدمات الإيصالات وقسائم الرواتب وكشوف الحساب المستند في حقل نصي.
- منصات التوقيع الإلكتروني وإدارة المستندات. يعود المستند الموقّع من خدمة التوقيع بترميز Base64.
- مصدر رسائل البريد الإلكتروني. في المصدر الخام للرسالة، تُخزَّن مرفقات PDF على شكل كتل Base64.
1. اعثر على الكود وانسخه كاملًا
- استجابة JSON: ابحث عن الحقل الذي يحمل ملف PDF، وكثيرًا ما يكون اسمه pdf أو content أو data أو document أو file أو label. تبدأ قيمته بالأحرف JVBERi0. انسخ كل ما بين علامتي التنصيص. ويمكنك أيضًا نسخ الاستجابة كلها، فالأداة تعثر وحدها على الجزء الذي يبدأ بالأحرف JVBERi0.
- ملف XML: ابحث عن العنصر الذي يحمل ملف PDF (مثل EmbeddedDocumentBinaryObject) وانسخ النص الواقع بين وسم البداية ووسم النهاية. لا مشكلة في فواصل الأسطر.
- مصدر الرسالة: افتح خيار «Show original» أو «View source» (أي عرض الرسالة الأصلية أو مصدرها). مرفق PDF هو الكتلة الواقعة تحت السطرين Content-Type: application/pdf وContent-Transfer-Encoding: base64. انسخ كل شيء حتى أول سطر فارغ بعدها.
- أدوات المطور: في تبويب Network بالمتصفح، افتح الاستجابة، وانقر بزر الفأرة الأيمن على الحقل واختر «Copy value» (نسخ القيمة). هذه الطريقة أوثق بكثير من تحديد نص طويل يدويًا.
ولأن الكود طويل جدًا، فمن السهل أن تُقطع نهايته. بعد النسخ، تأكد من أن ما لصقته ينتهي بالطريقة نفسها التي ينتهي بها في المصدر.
2. حوّل الكود وتحقق من المستند
افتح Base64 إلى PDF، واضغط «أو اكتب نصًا أو الصقه»، ثم الصق الكود. بمجرد فك الترميز تظهر الصفحة الأولى، ويظهر تحتها عدد الصفحات وإصدار PDF وحجم الملف. وإذا كان الكود محفوظًا في ملف .txt، فما عليك إلا اختيار هذا الملف.
تتيح لك المعاينة التحقق سريعًا:
- هل هو المستند الصحيح؟ رقم الفاتورة أو اسم العميل أو بيانات الملصق ظاهرة في الصفحة الأولى.
- هل عدد الصفحات كما توقعت؟ الصفحات الناقصة تعني أن الكود نُسخ جزئيًا فقط.
- هل الملف محمي بكلمة مرور؟ عندها تظهر ملاحظة بدلًا من المعاينة، ويُحفظ الملف كما هو تمامًا.
3. احفظ ملف PDF وافتحه
اضغط «تنزيل PDF». يُحفظ الملف دون أي تغيير، ويفتح في أي قارئ PDF. وبعدها الأمر لك: اجمع فواتير شهر كامل في ملف واحد باستخدام دمج PDF، أو صغّر حجمه ليناسب البريد الإلكتروني باستخدام ضغط PDF، أو احصل على صورة للصفحة الأولى باستخدام PDF إلى JPG.
ماذا تخبرك بداية الكود؟
| بداية الكود | الملف الذي بداخله |
|---|---|
| JVBERi0 | مستند PDF |
| data:application/pdf;base64, | مستند PDF (بصيغة data URI) |
| iVBORw0KGgo | صورة PNG |
| /9j/ | صورة JPG |
| UEsDB | ملف ZIP أو Word (.docx) أو Excel (.xlsx) |
| PD94bWwg | نص XML (مثل بيانات الفاتورة نفسها) |
يفسّر السطر الأخير التباسًا شائعًا مع الفواتير الإلكترونية: بعض الخدمات ترسل ملف XML للفاتورة بترميز Base64 بدلًا من ملف PDF. وعند فك ترميز هذا الكود تحصل على نص XML مقروء، لا على مستند.
أخطاء شائعة
حفظ الكود كملف نصي بامتداد .pdf. يبقى الملف محتويًا على نص Base64، ويعرضه القارئ على أنه تالف. يجب فك ترميز الكود أولًا.
نسخ أكثر من القيمة. إذا انتهى الكود بفاصلة «,» زائدة أو بكلمة «status»، يصبح غير صالح. انسخ القيمة وحدها أو الاستجابة كاملة، فالأداة تستخرج الكود بشكل صحيح في الحالتين.
فواصل الأسطر المكتوبة كرموز. في نصوص JSON قد يُقسَّم الكود كل 76 حرفًا بالرمز \n. هذه الرموز ليست جزءًا من ملف PDF، وتحذفها الأداة تلقائيًا.
الاستجابة الخاطئة. إذا لم يكن المستند جاهزًا بعد، تعيد بعض واجهات API حقلًا فارغًا أو رسالة خطأ. وإذا كان الكود قصيرًا جدًا، أي بضع مئات من الأحرف، فهو على الأرجح نص خطأ وليس ملف PDF.
ملاحظة حول الخصوصية
لا يحمي Base64 مستندك، بل يغيّر صيغته فقط. تجنّب فك ترميز الفواتير أو العقود أو التقارير الطبية أو نسخ الهويات على مواقع ترفع الملف إلى خادم. تفك أداة PDFVela ترميز الكود على جهازك، وتواصل العمل حتى لو انقطع اتصالك بالإنترنت بعد فتح الصفحة.
هل أنت مستعد للتجربة؟ الأداة مجانية، ويبقى ملفك على جهازك.
افتح أداة Base64 إلى PDF