EN عر

تنسيق استجابة JSON من API — اقرأ وتحقق في ثوانٍ

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

💡 سير العمل الموصى به لاستجابات API: الصق الاستجابة الخام → اضغط تنسيق للقراءة → اضغط تحقق للتأكد من صحة البنية → انسخ النتيجة المنسّقة للتوثيق. 

      

      
    

  




  

    
لماذا يحتاج المطوّر لتنسيق استجابات JSON من API؟

    
كل من عمل مع APIs يعرف المشهد: تُرسل طلباً وتحصل على استجابة JSON مضغوطة في سطر واحد طوله آلاف الحروف. قراءتها مباشرةً في المتصفح أو في terminal شبه مستحيلة. التنسيق يُحوّل هذا الخط الطويل إلى بنية هرمية مقروءة في ثانية واحدة — مع تلوين الأنواع المختلفة (مفاتيح، نصوص، أرقام، قيم منطقية) لتمييزها بسرعة.

    
الفائدة الثانية أهم: التحقق من صحة البنية قبل استخدام الاستجابة في الكود. أخطاء JSON الشائعة في استجابات API — كالفاصلة الزائدة أو القوس المفقود — تُسبب أخطاء غامضة في runtime يستغرق تتبّعها دقائق. ثانية واحدة في "تحقق" توفّر عليك هذا الوقت كاملاً. كثير من استجابات API تحتوي حقول id بصيغة UUID — إذا احتجت توليد معرّفات للاختبار، راجع دليل UUID v4.


    
سير العمل الأمثل مع استجابات API

    

      

        
1

        

          
انسخ الاستجابة الخام من أداة الاختبار

          
من Postman أو Insomnia أو curl أو Network tab في DevTools: انسخ جسم الاستجابة (Response Body) كاملاً.

        

      

      

        
2

        

          
الصقها في حقل الإدخال

          
الصق JSON الخام في الحقل أعلاه. يمكن أن يكون مضغوطاً في سطر واحد أو موسّعاً جزئياً — الأداة تتعامل مع الحالتين.

        

      

      

        
3

        

          
اضغط تنسيق أو تحقق

          
اضغط "تنسيق" للحصول على بنية مقروءة مع تلوين بناء الجملة. اضغط "تحقق" للتأكد من صحة البنية قبل استخدام الاستجابة.

        

      

      

        
4

        

          
انسخ أو وثّق

          
انسخ JSON المنسّق للصقه في التوثيق أو ملف README. أو اضغط "تصغير" لإزالة المسافات قبل تضمينه في ملف إعداد.

        

      

    


    
أكثر أخطاء JSON شيوعاً في استجابات API

    

      

        
⚠️ الفاصلة الزائدة (Trailing Comma)

        
فاصلة بعد آخر عنصر في الكائن أو المصفوفة. مقبولة في JavaScript لكن JSON يرفضها تماماً. الأكثر شيوعاً في استجابات API المكتوبة يدوياً.

      

      

        
⚠️ قوس غير مغلق

        
كائن مفتوح بـ { بدون } مقابل، أو مصفوفة [ بدون ]. يحدث غالباً في الاستجابات الكبيرة أو عند بناء JSON ديناميكياً.

      

      

        
⚠️ مفتاح بدون علامات اقتباس

        
{ name: "Ahmed" } صحيح في JavaScript لكن خاطئ في JSON — المفتاح يجب أن يكون "name" (بعلامات اقتباس مزدوجة).

      

      

        
⚠️ قيمة undefined أو NaN

        
JSON لا يدعم undefined وNaN وInfinity. إذا أعادت API هذه القيم، تكون الاستجابة خاطئة وتحتاج إعادة النظر في منطق الخادم.

      

    


    
أسئلة شائعة عن تنسيق JSON لاستجابات API

    

      
      
الخوادم ترسل JSON مضغوطاً في بيئة الإنتاج لتقليل حجم البيانات المنقولة وتسريع الاستجابة. الضغط يحذف المسافات والأسطر الجديدة دون تغيير البيانات. المنسّق يُعيد إضافة هذه المسافات للقراءة فقط.

    

    

      
      
نعم. جميع المعالجة تتم في متصفحك محلياً باستخدام JSON.parse() المدمج في المتصفح. بيانات API لا تُرسل لأي خادم خارجي. مثالي للعمل مع استجابات تحتوي tokens أو بيانات مستخدمين حساسة.

    

    

      
      
الفاصلة الزائدة (trailing comma) بعد آخر عنصر، القوس غير المغلق، مفتاح بدون علامات اقتباس مزدوجة، وقيمة undefined أو NaN التي لا يدعمها JSON. الأداة تُحدد موضع الخطأ بدقة مع رقم السطر.

    

    

      
      
الصق JSON في الحقل واضغط "تحقق". إذا كانت البنية صحيحة ستظهر رسالة نجاح خضراء. إذا كان هناك خطأ ستظهر رسالة تحدد السطر والمشكلة بدقة — مثل "Unexpected token at line 15, column 8".

    

    

      
      
التنسيق (pretty-print) يُضيف مسافات وأسطر جديدة لجعل JSON قابلاً للقراءة — مثالي للتطوير والتوثيق. التصغير (minify) يحذف جميع المسافات لتقليل حجم الاستجابة — مثالي في بيئة الإنتاج لتسريع نقل البيانات.

    

    

      
      
نعم. استجابات GraphQL تعود بصيغة JSON قياسية ضمن حقل "data" (أو "errors" عند الخطأ). الصق جسم الاستجابة الكامل وسيُنسّقه المنسّق بشكل صحيح.

    


    

      
أدوات وقراءات ذات صلة