إنشاء مسارات API

مسارات API تتيح لك إنشاء نقطة نهاية API داخل تطبيق Next.js. يمكنك القيام بذلك عن طريق إنشاء وظيفة داخل دليل pages/api بالصيغة التالية:

// req = رسالة HTTP الواردة، res = استجابة خادم HTTP
export default function handler(req, res) {
  // ...
}

تعرف على المزيد حول معالج الطلب أعلاه في توثيق مسارات API.

يمكن نشرها كوظائف بلا خادم (تُعرف أيضًا باسم Lambdas).

إنشاء نقطة نهاية API بسيطة

لنجرب ذلك. أنشئ ملفًا باسم hello.js في pages/api بالكود التالي:

export default function handler(req, res) {
  res.status(200).json({ text: 'Hello' });
}

حاول الوصول إليه عبر http://localhost:3000/api/hello. يجب أن ترى {"text":"Hello"}. لاحظ أن:

• req هو نسخة من http.IncomingMessage، بالإضافة إلى بعض الوسائط المسبقة الصنع.
• res هو نسخة من http.ServerResponse، بالإضافة إلى بعض وظائف المساعدة.

هذا كل شيء! قبل أن ننهي هذا الدرس، لنتحدث عن بعض النصائح لاستخدام مسارات API في الصفحة التالية.