في رد JSON من شركة الشحن صورة البوليصة مكتوبة كنص Base64 طويل، كيف أرجعها إلى ملف صورة أو PDF أفتحه؟
الصق قيمة Base64 وحدها، دون علامتي الاقتباس حولها، في وضع «فك الترميز». حين لا تكون البايتات نصًا، تعرض الأداة نوع الملف الذي تعرفت عليه وأول بايتاته، وتتيح لك تنزيله بالامتداد المناسب. وتقبل أيضًا القيمة التي تبدأ بمثل data:application/pdf;base64,.
لماذا تصل البوليصة نصًا؟
رد JSON نص، ولا يستطيع أن يحمل بايتات ملف PDF أو صورة كما هي. لذلك تكتب شركات الشحن وكثير من الأنظمة الملف بصيغة Base64، أي بحروف وأرقام ورموز قليلة تمر داخل النص دون مشكلة. الملف نفسه لم يتغير، هو فقط مكتوب بطريقة أخرى، وفك الترميز يعيد البايتات الأصلية كما هي.
وتذكّر أن Base64 ترميز لا تشفير: أي شخص يحصل على هذا النص يستطيع إعادته إلى البوليصة وقراءة عنوان العميل ورقم جواله. عامله كما تعامل الملف نفسه.
كيف تعرف الأداة نوع الملف؟
كل صيغة ملف تبدأ ببايتات ثابتة تسمى التوقيع. جربنا الأداة على بداية ملف PNG:
iVBORw0KGgo=
فظهر أن الناتج ليس نصًا بترميز UTF-8، وأن نوع الملف حسب توقيعه PNG، وأن أول البايتات هي 89 50 4E 47 0D 0A 1A 0A، ثم زر «تنزيل البيانات ملفًا» الذي يحفظه باسم decoded.png. الأنواع التي تتعرف عليها الأداة هي PNG وJPEG وGIF وWebP وPDF وZIP وGZIP، وأي نوع آخر يُنزَّل بامتداد bin، ويمكنك تغيير الامتداد بنفسك إن كنت تعرف النوع.
الخطوات
- في رد JSON انسخ القيمة الطويلة فقط، من أول حرف بعد علامة الاقتباس إلى آخر حرف قبل علامة الإغلاق.
- افتح ترميز وفك Base64 واختر «فك الترميز» والصق القيمة.
- اقرأ الملاحظة: نوع الملف وحجم البيانات.
- اضغط «تنزيل البيانات ملفًا» وافتح الملف الناتج.
أخطاء النسخ الشائعة من JSON
- نسخ علامة الاقتباس مع القيمة: جربنا ذلك فرفضت الأداة برسالة «الموضع 1: حرف ليس من أبجدية Base64» وأشارت إلى علامة الاقتباس.
- الشرطة المائلة المهرّبة: بعض أنظمة JSON تكتب / على شكل \/ داخل النص. الشرطة العكسية ليست من أبجدية Base64، فترفضها الأداة مع موضعها. احذف الشرطات العكسية أو انسخ القيمة من عارض JSON يعرضها بعد فك التهريب.
- قيمة مقطوعة: إن كان الرد طويلًا وقصّه البرنامج الذي تعرضه فيه، فقد ترفض الأداة الطول أو تعطيك ملفًا ناقصًا لا يُفتح. انسخ القيمة من الرد الكامل.
وإن ظهر الناتج نصًا يبدأ بعبارة %PDF؟
الأداة تعرض الناتج نصًا إذا كانت كل بايتاته حروفًا صالحة. جربنا بداية ملف PDF قصيرة جدًا فظهرت نصًا يبدأ بعبارة %PDF-1.4. هذا يعني أن البايتات ملف PDF، لكنها في هذا الجزء لا تحتوي إلا حروفًا. في هذه الحالة نزّل الناتج بزر النص ثم غيّر امتداد الملف إلى pdf، فالبايتات نفسها محفوظة.
وإن كانت البوليصة صورة بصيغة لا تناسب طابعتك أو برنامجك، فيمكنك تحويلها بعد التنزيل في تحويل صيغة الصور.
أسئلة شائعة
هل تُرفع البوليصة إلى خادم أثناء الفك؟
لا. الفك يتم داخل متصفحك، ولا يُرسل النص ولا الملف إلى أي مكان.
هل هناك حد لطول النص؟
نعم، مليونا حرف للنص الملصوق، وهذا يكفي لملف يقارب 1.5 ميغابايت.
هل الأداة تفتح الملف بنفسها؟
لا، هي تعيد البايتات وتتيح تنزيلها. افتح الملف في البرنامج المناسب على جهازك.