كيفية استخدام مختبِر JSON Pointer
- الصق مستند JSON.
- أدخل مؤشراً مثل /users/0/roles/1 (اتركه فارغاً للإشارة إلى المستند بأكمله).
- اقرأ القيمة المحلولة وتصفّح جدول جميع المؤشرات لاختيار مؤشرات أخرى.
مزايا مختبِر JSON Pointer
- حلّ مؤشرات RFC 6901، بما في ذلك تهريب ~0 / ~1 وصيغة جزء URI (#/a/b)
- توضيح الرمز الذي فشل بالضبط مع إدراج المفاتيح الموجودة فعلاً
- عرض الرموز المرجعية (reference tokens) ومسار JSONPath المكافئ
- تعداد كل مؤشر في المستند مع نوعه ومعاينة له
- تقييم فوري
مثال على مختبِر JSON Pointer
حلّ مؤشر يتضمن مفتاحاً مهرَّباً
الإدخال:
Pointer: /users/0/a~1b
Document: {"users":[{"a/b":"slash key"}]}النتيجة:
"slash key"الأسئلة الشائعة حول مختبِر JSON Pointer
ما الفرق بين JSON Pointer وJSONPath؟
المؤشر (RFC 6901) يحدد موقعاً واحداً بالضبط، مثل /users/0/name، ويُستخدم في JSON Patch ومراجع $ref في JSON Schema وOpenAPI. أما JSONPath فهو لغة استعلام يمكن أن تعيد نتائج مطابقة متعددة.
كيف أشير إلى مفتاح يحتوي على "/" أو "~"؟
هرّب "~" بكتابتها ~0 و"/" بكتابتها ~1. فمثلاً يصبح المفتاح "a/b" هو /a~1b، ويصبح "m~n" هو /m~0n.
ماذا يعني المؤشر الفارغ ""؟
يشير إلى المستند بأكمله. أما المؤشر المكوّن من "/" وحدها فيشير إلى خاصية اسمها سلسلة نصية فارغة.
هل يمكنني استخدام صيغة جزء URI؟
نعم. تُقبل المؤشرات مثل #/definitions/User، وتُفكّ الأحرف المرمّزة بالنسبة المئوية (percent-encoded) في الجزء تلقائياً.