قبل أن تبدأ
- مشروع Next.js أو خادم Node.js يعمل محلياً
- صلاحية تعديل ملفات الخادم
- فهم بسيط لطلبات POST وJSON
مكان الزر وطريقة التنفيذ
أنشئ مسار API
في Next.js App Router أنشئ الملف app/api/chat/route.ts. هذا يجعل العنوان /api/chat متاحاً من موقعك.
استخدم POST فقط
صدّر دالة POST واستقبل request. لا تضع المفتاح أو الاستدعاء في Client Component.
اقرأ JSON بأمان
استخدم await request.json() داخل try/catch، ثم استخرج الرسالة المطلوبة فقط.
أعد استجابة واضحة
استخدم NextResponse.json مع حقل نتيجة عند النجاح ورسالة عامة عند الخطأ دون كشف تفاصيل الخادم.
كيف تعرف أن الخطوة نجحت؟
- طلب POST إلى /api/chat يرجع JSON
- فتح المسار بـGET لا ينفذ عملية مدفوعة
- لا يظهر مفتاح API داخل View Source أو Network
إذا لم تجد الزر أو لم تعمل الخطوة
404 Not Found
تأكد من اسم الملف route.ts ومن وجوده داخل app/api/chat.
405 Method Not Allowed
استخدم POST من الواجهة ولا تفتح المسار كصفحة GET.
تنبيه مهم
لا تجعل endpoint يمرر أي نص مباشرة إلى المزود قبل التحقق من الحجم والهوية.