تنسيق JSON والتحقق منه: من رسالة الخطأ إلى مخطط جاهز

رسائل الخطأ في المتصفح قد تكون غامضة، لذلك من المفيد استخدام أداة تحدد رقم السطر والعمود. ابدأ من الموضع المشار إليه، ثم ابحث قبلَه بسطر أو سطرين لأن الخطأ الحقيقي غالبًا يسبق مكان اكتشافه.

• فاصلة ناقصة بين العناصر أو فاصلة زائدة بعد آخر عنصر.
• استخدام علامات تنصيص مفردة بدل المزدوجة.
• وجود تعليق داخل JSON؛ التعليقات غير مسموح بها في المعيار.
• قيم غير مدعومة مثل undefined أو NaN.

1. 1الصق النص أو الحمولة في مساحة JSON/YAML في استوديو صيغ البيانات.
2. 2اضغط التحقق لتحديد موضع أي خطأ نحوي، ثم صحّحه.
3. 3اختر التنسيق أو التحويل المطلوب (YAML، XML، TOML) بحسب النظام الذي تستهدفه.
4. 4إذا كنت ستبني عميل API، استخدم مساحة المخططات لتوليد واجهة TypeScript أو مخطط Zod.
5. 5راجع المخطط الناتج وأضف الحقول الاختيارية التي لم تظهر في العيّنة.

الاستنتاج يقرأ القيم الموجودة أمامه فقط. إذا كان حقل ما فارغًا في كل العيّنات التي جربتها، فقد يظهر كأنه اختياري رغم أنه إلزامي في الإنتاج، والعكس ممكن. اعتبر المخطط الناتج نقطة انطلاق، ثم قارنه بوثائق API الرسمية أو عيّنات من أزمنة مختلفة.

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