تنسيق JSON ومعرفة مكان الخطأ
أرسلت لك منصة الدفع أو شركة الشحن ردًا بصيغة JSON في سطر واحد طويل، وتريد أن تعرف ما فيه. أو أضفت منتجًا إلى ملف إعدادات فتوقف المتجر عن قراءته. التنسيق يجعل البيانات مقروءة، ويخبرك أين الخطأ بالضبط.
ما هو JSON؟
صيغة نصية لتبادل البيانات بين الأنظمة، تستخدمها معظم واجهات البرمجة ومنصات المتاجر. قواعدها صارمة: المفاتيح بين علامتي تنصيص مزدوجتين، ولا فاصلة بعد آخر عنصر، ولا تعليقات. خطأ صغير واحد يجعل الملف كله غير صالح.
النص المضغوط التالي، وحجمه 26 بايت:
بعد التنسيق بمسافتين يصبح تسعة أسطر مرتبة، وحجمه 57 بايت. عمقه 2، وفيه 3 مفاتيح.
{"b":[1,2],"a":{"c":null}}
أين الخطأ؟
النص المكوّن من 3 أسطر: قوس الفتح، ثم "a": 1 مع فاصلة، ثم قوس الإغلاق، غير صالح بسبب الفاصلة الأخيرة. الأداة تحدد الخطأ في السطر 3، العمود 1: قوس الإغلاق في مكان كان يُنتظر فيه اسم مفتاح. والأداة لا تصلح الخطأ من تلقاء نفسها، بل تريك مكانه لتقرر أنت.
الطريقة
- افتح منسّق ومدقّق JSON والصق JSON، أو افتح ملفًا.
- اختر التنسيق بمسافتين أو أربع أو بعلامة جدولة، أو الضغط في سطر واحد.
- إن كان هناك خطأ، اقرأ الرسالة والسطر والعمود وصحّح النص.
- انسخ النتيجة أو نزّلها.
ما يجب أن تعرفه
- الحد 5 ميغابايت. ملف بهذا الحجم نُسّق وعُرض في نحو 3 ثوانٍ.
- الأعداد الصحيحة الأكبر من 9007199254740991 تفقد دقتها في JavaScript، والأداة تنبهك. احفظها كنصوص إن كانت أرقام تعريف.
- إن تكرر مفتاح في الكائن نفسه تبقى القيمة الأخيرة فقط، والأداة تسرد المفاتيح المكررة.
- رسالة الخطأ تأتي من متصفحك بالإنجليزية، وتختلف قليلًا بين المتصفحات.
وإن كانت بياناتك جدولًا تريد فتحه في Excel، حوّلها عبر محوّل CSV و JSON. وإن وجدت قيمة مشفرة بصيغة Base64 داخل JSON، افكها عبر ترميز وفك Base64.
أسئلة شائعة
هل تصلح الأداة JSON المكسور؟
لا. هي تريك مكان الخطأ فقط، لأن الإصلاح التلقائي قد يغيّر بياناتك دون أن تنتبه.
هل JSON الذي أرسله إلى الأداة آمن؟
نعم، يُقرأ داخل متصفحك ولا يُرسل إلى أي خادم. ومع ذلك لا تلصق مفاتيح سرية في أي مكان لا تحتاج إليه.
لماذا يبدو سطر فيه عربية وأرقام مقلوبًا؟
هكذا تعرض المتصفحات النص ثنائي الاتجاه. البيانات نفسها بالترتيب الصحيح حين تنسخها أو تنزّلها.