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