[دليل] بيانات JSON POST باستخدام NodeJS Express

NodeJS و ExpressJS هما تقنية شائعة لبناء تطبيقات الويب، خاصةً حيث توجد تفاعلات كثيرة من المستخدم وتحديثات في الوقت الحقيقي.

قبل أن تتمكن معظم التطبيقات من معالجة البيانات الواردة القادمة من واجهات برمجة التطبيقات، يلزم وجود برمجيات وسيطة لتحليل بيانات الطلبات HTTP بصيغة JSON إلى كائنات JavaScript. هذا ما سيغطيه هذا المقال!

تحليل بيانات POST بصيغة JSON إلى كائنات JavaScript باستخدام NodeJS Express

تحتوي إصدارات Express التي فوق الإصدار 4.16.0 على أدوات مدمجة لتحليل JSON إلى JavaScript. ومع ذلك، إذا كانت نسختك من Express أقل من 4.16.0، يمكنك استخدام سطر الشيفرة التالي لتثبيت body-parser، بمساعدة الطرفية الخاصة بك:

npm install body-parser

استخدام برمجيات وسيطة express.json()

داخل تطبيق Express الخاص بك، تأكد من إضافة برمجية الوسيطة express.json() قبل معالجات الطرق الخاصة بك. هذه البرمجية الوسيطة ستقوم تلقائيًا بتحليل الطلبات الواردة التي تحتوي على نوع محتوى JSON، وملء خاصية req.body بالكائن JavaScript المطلوب.

مثال على الشيفرة لاستخدام برمجية الوسيطة express.json() سيكون:

const express = require('express');
const app = express();

// تمكين تحليل JSON
app.use(express.json());

// معالجات الطرق الخاصة بك هنا...

app.listen(3000, () => console.log('الخادم يستمع على المنفذ 3000'));

الوصول إلى البيانات من جسم الطلب

بمجرد إعداد برمجية الوسيطة body-parser، يجب أن تكون قادرًا على الوصول إلى بيانات JSON المحللة من خاصية req.body في معالجات الطرق الخاصة بك، باستخدام مثال الشيفرة أدناه:

app.post('/data', (req, res) => {
  const name = req.body.name;
  const email = req.body.email;

  // فعل شيئًا ما مع البيانات
  console.log(`الاسم: ${name}، البريد الإلكتروني: ${email}`);

  res.send('تم استلام البيانات بنجاح!');
});

تأكد من أن عند إرسال مجموعة الطلبات، يتم استخدام رأس نوع المحتوى المناسب (وهو عادةً application/json على Express. هذا للتأكد من أن Express يمكنه التعرف عليه كطلب JSON.

عرض استجابات واجهة برمجة التطبيقات بوضوح باستخدام Apidog

فهم كيفية تصرف واجهات برمجة التطبيقات أمر أساسي في تطوير التطبيقات. لذلك، يجب أن تفكر في استخدام منصة قوية لتطوير واجهات برمجة التطبيقات مثل Apidog لاستضافة عمليات التطوير الخاصة بك.

استيراد واجهات برمجة التطبيقات الموجودة إلى Apidog

مع العديد من أنواع ملفات واجهات برمجة التطبيقات الموجودة، مثل Postman الشائعة، Swagger، وInsomnia، قد تشعر بالتردد لأنك لا تستطيع استيرادها إلى Apidog. ومع ذلك، هذا ليس صحيحًا!

يدعم Apidog استيراد جميع البدائل المذكورة وأكثر! مع أكثر من 10 أنواع من ملفات واجهات برمجة التطبيقات، يمكنك أن تكون مطمئنًا لاستيراد وتعديل واجهات برمجة التطبيقات بأمان من منصات أخرى في Apidog. كل ما عليك القيام به هو الانتقال إلى قسم Import Data الموجود تحت Settings، ويمكنك استيراد واجهة برمجة التطبيقات الخاصة بك!

واجهة مستخدم Apidog بسيطة وبديهية

سيلتقط كل من المستخدمين الجدد وذوي الخبرة واجهة مستخدم Apidog بسرعة بسبب سهولة التنقل! اختبر أي واجهة برمجة تطبيقات أو طلب من خلال التأكد من أن نقطة نهاية واجهة برمجة التطبيقات صحيحة، واضغط على زر Send بمجرد الانتهاء من كل شيء!

سوف تعرض Apidog جسم استجابة واجهة برمجة التطبيقات بوضوح كريستالي، مع خيار عرض استجابة واجهة برمجة التطبيقات بشكل مناسب وسهل القراءة، أو نسختها الخام الحقيقية. يمكنك أيضًا مشاهدة ما إذا كانت الاستجابة الفعلية ناجحة بناءً على استجابة الحالة التي returned from API.

توليد شيفرة JavaScript اللازمة باستخدام Apidog

يمتلك Apidog ميزة توليد الشيفرات التي تتيح للمستخدمين توليد الشيفرة لأكثر لغات البرمجة شعبية، مثل JavaScript وPython وJava والمزيد!

أولاً، ابحث عن زر </> الموجود في الزاوية العليا اليمنى من الشاشة. إذا كنت تواجه صعوبة في العثور على الزر، يمكنك الرجوع إلى الصورة أعلاه.

ثم اختر لغة البرمجة المستخدمة في جانب العميل التي تحتاجها. لديك القدرة على اختيار مكتبة JavaScript التي تشعر بالراحة معها أكثر. الآن كل ما عليك فعله هو نسخ الشيفرة ولصقها في IDE الخاص بك، والمتابعة لتعديلها لضمان ملاءمتها لتطبيق NodeJS الخاص بك!

خاتمة

يقدم NodeJS وExpress مجموعة قوية لبناء تطبيقات الويب التي تعتمد على تبادل بيانات JSON. من خلال استخدام برمجية الوسيطة express.json()، يمكنك بسهولة تحليل بيانات JSON الواردة في طلبات POST. هذا يبسط المهام مثل تسجيل المستخدمين، تحديث البيانات، والتفاعلات في الوقت الحقيقي.

مع الطبيعة المدفوعة بالأحداث لـ NodeJS وإدارة واجهة برمجة التطبيقات المبسطة من قبل Express، يمكنك إنشاء تطبيقات ويب ديناميكية وقابلة للتوسع تتكامل بسلاسة مع خدمات أخرى. لذا، في المرة القادمة التي تقوم فيها ببناء تطبيق ويب يتطلب التفاعل مع JSON، ضع في اعتبارك الكفاءة والمرونة اللتين يوفرهما NodeJS وExpress.