إصلاح · فيرسل والنشر

مسار API يعمل محلياً ويعطي 404 أو يفشل في الموقع الحي

لم يُفحص مقابل شاشات الجهة الحالية

ما قد تراه

fetch إلى /api/... يعمل على جهازي وليس على الإنترنت
الموقع تصدير ثابت (static) فلا يوجد API

السبب الأرجح

لا يشغّل الموقع الحي شيفرة الخادم عند ذلك العنوان: تصدير ثابت أو مجلد خاطئ للمسار أو طريقة (GET أو POST) لا يعالجها المسار.

افحص أولاً (نحو دقيقتين)

افتح العنوان الكامل للمسار في تبويب: هل ترى 404 أو 405 أو رداً حقيقياً؟
تحقق هل المشروع مصدَّر كملفات ثابتة (ابحث عن output: "export" أو إعداد استضافة ثابتة).

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

أنت مهندس خبير وصبور ينشر المواقع على Vercel كل يوم ويشرح ذلك لأشخاص ليسوا مبرمجين. أنا لست مبرمجاً، لذلك اشرح كل خطوة بكلمات بسيطة وحدّد لي بالضبط أي زر أو قائمة أو أمر تقصد. إذا لم تكن متأكداً من شيء فقل ذلك ولا تخمّن.

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

المشكلة
مسار API يعمل محلياً ويعطي 404 أو يفشل في الموقع الحي

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
لا يشغّل الموقع الحي شيفرة الخادم عند ذلك العنوان: تصدير ثابت أو مجلد خاطئ للمسار أو طريقة (GET أو POST) لا يعالجها المسار.

نفّذ هذه الخطوات بهذا الترتيب
1. تحقق من مكان ملف المسار واسمه الدقيق والطريقة المصدَّرة (GET أو POST).
2. تحقق من إعداد التصدير الثابت وهل يُسمح بشيفرة الخادم في إعداد الاستضافة هذا.
3. أصلح السبب الوحيد الذي وجدته وأعطني أمر curl لاختبار المسار.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- يرجع أمر curl الرد المتوقع من العنوان الحي.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا تنقل الموقع كله إلى استضافة أخرى لإصلاح مسار واحد.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

تحقق من مكان ملف المسار واسمه الدقيق والطريقة المصدَّرة (GET أو POST).
تحقق من إعداد التصدير الثابت وهل يُسمح بشيفرة الخادم في إعداد الاستضافة هذا.
أصلح السبب الوحيد الذي وجدته وأعطني أمر curl لاختبار المسار.

لا تفعل هذا

لا تضع مفاتيح سرية في صفحة ثابتة لتفادي المسار.
لا تنقل الموقع كله إلى استضافة أخرى لإصلاح مسار واحد.