المدونة

تنسيق JSON ونسخ JSON Pointer لقيمة محددة

نسّق استجابة API من سطر واحد في المتصفح وانسخ JSON Pointer لقيمة من عرض الشجرة. توضح الأمثلة أيضًا كيفية تصغير JSON وفحص صيغته.

تعرض الواجهة الإنجليزية JSON من سطر واحد إلى جانب الناتج ذي المسافات البادئة.

عندما تعيد API بيانات JSON في سطر واحد، تُسهّل إضافة فواصل الأسطر قراءة القيم. إذا أردت الإبلاغ عن نفاد مخزون المنتج الثاني، أرفق مسار القيمة حتى يسهل على غيرك العثور عليها. جرّب العمليتين على قائمة منتجات افتراضية باستخدام أداة تنسيق JSON وتصغيره والتحقق منه. تُعالَج البيانات الملصقة داخل المتصفح.

تسهيل قراءة استجابة من سطر واحد

ألصق المثال التالي في حقل «JSON المدخل».

{"items":[{"sku":"A-001","stock":12},{"sku":"B-002","stock":0}]}
  1. اضبط «المسافة البادئة» على 2 واضغط على «تنسيق (Pretty) →».
  2. ابحث في «المخرجات» عن العنصر الثاني من المصفوفة items. قيمة stock للمنتج ذي الرمز sku الذي يساوي B-002 هي 0.
  3. لحفظ الناتج المنسّق في ملف، اضغط على «نسخ» ثم ألصقه في محرر واحفظه. إذا أردته في سطر واحد مضغوط، فاضغط على «ضغط (Minify) →» قبل النسخ.
تعرض الواجهة الإنجليزية قائمة المنتجات في حقل الإدخال وJSON منسّقًا بمسافتين بادئتين في حقل الإخراج.
يسهّل عرض الإدخال والإخراج في حقلين منفصلين مقارنة السطر الأصلي بالبنية بعد التنسيق.

العثور على مسار مخزون المنتج الثاني في الشجرة

  1. مع إبقاء الإدخال نفسه، اضغط على «العرض الشجري».
  2. وسّع items ثم [1] واختر "stock": 0. تبدأ فهارس المصفوفة من الصفر، لذا يمثّل [1] العنصر الثاني.
  3. تحقق من أن JSON Pointer المحدد هو /items/1/stock واضغط على «نسخ المسار». سجّل المسار مع تحديد الاستجابة التي فحصتها.
تعرض الشجرة الإنجليزية العنصر الثاني في items، ويظهر المسار /items/1/stock بعد اختيار stock.
يعرض حقل المسار موضع القيمة المحددة. القيمة نفسها هي 0.

في JSON Pointer تُمثّل الشرطة المائلة في المفتاح بالرمز ~1، وتُمثّل العلامة المتموجة بالرمز ~0. مثلًا، يصبح المفتاح الواحد stock/on-hand هو stock~1on-hand. راجع صيغة RFC 6901.

فحص الصيغة إذا تعذّر التنسيق

إذا كتبت العنصر الثاني على هيئة {"sku":"B-002","stock":0,}، فستتسبب الفاصلة قبل قوس الإغلاق في خطأ في الصيغة. اضغط على «تحقق» للفحص. إذا أعطى المتصفح موضع الخطأ، ستظهر أرقام السطر والعمود. احذف الفاصلة، ثم اضغط على «تحقق» مرة أخرى قبل التنسيق.

يفحص «تحقق» صيغة JSON. لمعرفة ما إذا كان stock إلزاميًا أو يقبل قيمًا سالبة، ارجع إلى مواصفات API أو مخططها.