Home / मार्गदर्शक / Next.js फॉर्म बॅकएंड इंटिग्रेशन (ॲप राउटर आणि सर्व्हर क्रिया)
एकत्रीकरण मार्गदर्शक · समोरील भाग आणि पुढील.जे.एस

Next.js फॉर्म बॅकएंड इंटिग्रेशन (ॲप राउटर आणि सर्व्हर क्रिया)

नेक्स्ट.जेएस 14/15 मध्ये संपर्क फॉर्म हाताळण्यासाठी पूर्ण टाईपस्क्रिप्ट आणि प्रतिक्रिया अंमलबजावणी मार्गदर्शक Lugatu एंडपॉइंट्स आणि शून्य क्रेडेंशियल एक्सपोजरसह सर्व्हर क्रिया वापरून.

1. सर्व्हर क्रियांसह Next.js ॲप राउटर आर्किटेक्चर

Next.js सर्व्हर क्रिया केवळ सर्व्हरवर कार्यान्वित करतात, त्यांना क्लायंट बंडलमधील रहस्ये उघड न करता खाजगी Lugatu API की सह चौकशी सबमिट करण्यासाठी आदर्श बनवतात.

app/actions/contact.ts typescript
'use server';

export async function submitContact(prevState: any, formData: FormData) {
  // Silent rejection of automated bot submissions via honeypot trap
  const honeypot = (formData.get('_gotcha') as string) || '';
  if (honeypot) {
    return { success: true, error: null };
  }

  const name = formData.get('name') as string;
  const email = formData.get('email') as string;
  const message = formData.get('message') as string;

  if (!name || !email || !message) {
    return { success: false, error: 'All fields are required.' };
  }

  const payload = {
    fields: { name, email, message },
  };

  try {
    const res = await fetch(`https://www.lugatu.com/api/v1/forms/${process.env.LUGATU_FORM_ID}/submissions`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.LUGATU_API_KEY}`,
        'Content-Type': 'application/json',
        'Idempotency-Key': crypto.randomUUID(),
      },
      body: JSON.stringify(payload),
    });

    if (!res.ok) {
      return { success: false, error: 'Failed to submit form.' };
    }

    return { success: true, error: null };
  } catch (err) {
    return { success: false, error: 'Network error occurred.' };
  }
}

2. लोडिंग स्टेटसह क्लायंट-साइड फॉर्म घटक

प्रवेशयोग्य लोडिंग संकेतकांसह आपल्या सर्व्हर क्रिया प्रतिक्रिया 19 / Next.js क्लायंट घटकाशी कनेक्ट करा.

components/ContactForm.tsx tsx
'use client';

import { useActionState } from 'react';
import { submitContact } from '@/app/actions/contact';

export function ContactForm() {
  const [state, formAction, isPending] = useActionState(submitContact, { success: false, error: null });

  return (
    <form action={formAction} className="space-y-4 max-w-md">
      <div>
        <label className="block text-sm font-semibold mb-1">Name</label>
        <input name="name" required className="w-full border rounded-xl p-2.5" />
      </div>
      <div>
        <label className="block text-sm font-semibold mb-1">Email</label>
        <input type="email" name="email" required className="w-full border rounded-xl p-2.5" />
      </div>
      <div>
        <label className="block text-sm font-semibold mb-1">Message</label>
        <textarea name="message" rows={4} required className="w-full border rounded-xl p-2.5" />
      </div>

      <input type="text" name="_gotcha" style={{ display: 'none' }} tabIndex={-1} autoComplete="off" />

      <button type="submit" disabled={isPending} className="btn-primary-editorial w-full py-2.5">
        {isPending ? 'Sending...' : 'Send Message'}
      </button>

      {state.success && <p className="text-emerald-700 text-sm">Thank you! Your message was received.</p>}
      {state.error && <p className="text-red-700 text-sm">{state.error}</p>}
    </form>
  );
}

सुरक्षा आणि प्रमाणीकरण अपरिवर्तनीय

सुरक्षा सूचना: NEXT_PUBLIC_ सह LUGATU_API_KEY कधीही उपसर्ग करू नका. फक्त खाजगी सर्व्हर-साइड व्हेरिएबल्स तुमची थेट API की सुरक्षितपणे धारण करू शकतात.

समस्यानिवारण आणि सामान्य अंतर्ग्रहण त्रुटी

API की विनंती 403 FORBIDDEN_BROWSER_ORIGIN परत करते

तुम्ही API की वापरून क्लायंट-साइड ब्राउझर कोडवरून fetch() कॉल करत आहात. एकतर नेक्स्ट.जेएस सर्व्हर ॲक्शनवर स्विच करा किंवा एपीआय की शिवाय सार्वजनिक फॉर्म एंडपॉइंट वापरा.

वारंवार विचारले जाणारे प्रश्न

मी हे Vercel किंवा Cloudflare पृष्ठांवर उपयोजित करू शकतो?

होय. सर्व्हर क्रिया सर्व सर्व्हरलेस प्लॅटफॉर्मवर अखंडपणे कार्य करतात आणि Next.js द्वारे समर्थित एज रनटाइम्स.

तुमचा फॉर्म एंडपॉइंट तयार करण्यास तयार आहात?

काही सेकंदात विनामूल्य प्रारंभ करा. क्रेडिट कार्ड आवश्यक नाही.

विनामूल्य प्रारंभ करा →