البنية التحتية للمطورين · بدون خادم وJAMSTACK

خلفية نموذجية موثوقة دون الصداع SMTP.

قم بتوصيل نماذج HTML أو React أو Next.js أو Astro أو النماذج المخصصة مباشرةً بنقطة نهاية Lugatu. تعمل تصفية مصيدة مكافحة البريد العشوائي وإدارة صندوق الوارد المركزي وتسليم الإشعارات بشكل خارج الصندوق دون تكوين خادم.

خادم صفر وصفر SMTP

لا تكشف مطلقًا عن بيانات اعتماد SMTP أو كلمات مرور البريد الإلكتروني في رمز الواجهة الأمامية. تجنب فشل التسليم والقوائم السوداء للبريد العشوائي دون عناء.

مصيدة الجذب الذكية وتحديد المعدل

دفاع خالي من الاحتكاك ضد البريد العشوائي. قم بحظر روبوتات البريد العشوائي الآلية بصمت دون إزعاج زوار موقعك الحقيقيين بالألغاز الصعبة.

صندوق وارد مركزي متين

يتم تخزين كل استجابة بأمان في صندوق الوارد الخاص بمساحة العمل الخاصة بـ PostgreSQL. لا يتم تجاهل الرسائل مطلقًا حتى لو تم الوصول إلى حدود البريد الإلكتروني الصادر.

1. لماذا يقوم المطورون بإزالة SMTP لنماذج الويب

تعاني نماذج الويب التقليدية التي تعتمد على SMTP أو PHP mail() من معدلات فشل عالية، وبيانات الاعتماد المكشوفة في حزم العميل، وكتل المنافذ على الأجهزة المضيفة الحديثة التي لا تحتوي على خادم. يستبدل Lugatu خوادم البريد الهشة بخط أنابيب مرن لاستيعاب نماذج HTTPS للمعاملات مدعومًا بـ PostgreSQL.

info

يتعامل Lugatu مع حدود معدلات SPF وDKIM وDMARC وISP نيابةً عنك. وتستمر عمليات الإرسال قبل إرسال الإخطارات، مما يضمن عدم فقدان أي استفسارات.

2. استيعاب نموذج المتصفح من جانب العميل

بالنسبة للنماذج من جانب العميل على المواقع الثابتة، قم بإرسال الاستفسارات بتنسيق JSON مباشرةً إلى نقطة نهاية النموذج العام لديك. قم بتضمين حقل مصيدة غير مرئية لحظر البريد العشوائي التلقائي بدون اختبار CAPTCHA الذي يواجه المستخدم.

contact-form.html html
<form id="contact-form">
  <input type="text" name="name" placeholder="Your Name" required />
  <input type="email" name="email" placeholder="you@domain.com" required />
  <textarea name="message" placeholder="How can we help?" required></textarea>

  <!-- Invisible Honeypot Field (Bots fill this; real users ignore it) -->
  <input type="text" name="_gotcha" style="display:none !important" tabindex="-1" autocomplete="off" />

  <button type="submit">Send Message</button>
</form>

<script>
document.getElementById('contact-form').addEventListener('submit', async (e) => {
  e.preventDefault();
  const form = e.target;
  const formData = new FormData(form);

  const payload = {
    fields: {
      name: formData.get('name'),
      email: formData.get('email'),
      message: formData.get('message')
    },
    honeypot: formData.get('_gotcha') || ''
  };

  const response = await fetch('https://www.lugatu.com/api/v1/public/forms/YOUR_PUBLIC_FORM_ID/submissions', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json'
    },
    body: JSON.stringify(payload)
  });

  if (response.ok) {
    alert('Thank you! Your message was received.');
    form.reset();
  }
});
</script>
استبدل YOUR_PUBLIC_FORM_ID بالمعرف العام من لوحة تحكم Lugatu.

3. عمليات الإرسال البرمجية من خادم إلى خادم

بالنسبة لتطبيقات الواجهة الخلفية والخدمات الصغيرة والأطر المقدمة بواسطة الخادم، توفر Lugatu نقطة نهاية إرسال برمجية معتمدة ومصادق عليها باستخدام مفتاح API المباشر لمساحة العمل الخاصة بك.

submit.sh bash
curl -X POST "https://www.lugatu.com/api/v1/forms/YOUR_FORM_GUID/submissions" \
  -H "Authorization: Bearer lug_live_your_secret_api_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "fields": {
      "name": "Alex Taylor",
      "email": "alex@studio.design",
      "message": "Project consultation request from custom backend service."
    }
  }'
يتم رفض مفاتيح API من خادم إلى خادم بشكل صارم إذا تم إرسالها من أصول متصفح خارجي.

الأمن المعماري والمفتاح الثابت

سياسة أمان واجهة برمجة التطبيقات: مفاتيح Lugatu Live API (lug_live_...) هي بيانات اعتماد صارمة من خادم إلى خادم. لا تقم مطلقًا بتضمين مفاتيح واجهة برمجة التطبيقات (API) في HTML من جانب العميل، أو حزم الأجهزة المحمولة، أو البرامج النصية للواجهة الأمامية. بالنسبة للنماذج من جانب العميل، استخدم دائمًا نقطة نهاية النموذج العام (POST /api/v1/public/forms/{publicFormId}/submissions).

استكشاف الأخطاء وإصلاحها وأخطاء العرض الشائعة

منعت سياسة CORS التقديم

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

أدى الإرسال إلى إرجاع 400 طلب غير صالح مع FORM_FIELDS_REQUIRED

تحقق من بنية حمولة JSON الخاصة بك. يجب أن تتضمن الاستعلامات مدخلات النموذج داخل كائن "الحقول" ذي المستوى الأعلى: {"fields": {"name": "..."، "email": "..."}}.

الأسئلة المتداولة

هل أحتاج إلى خادم SMTP أو مزود بريد إلكتروني لاستخدام Lugatu؟

لا، تتولى Lugatu التعامل مع جميع عمليات تسليم البريد الإلكتروني وإدارة الحصص والتحقق من نظام التعرف على هوية المرسل (SPF)/DKIM بشكل خارج الصندوق باستخدام بنية أساسية عالية السمعة لتسليم المعاملات.

ماذا يحدث إذا تم الوصول إلى حصة الإشعارات الشهرية الخاصة بي؟

لا تضيع التقديمات الخاصة بك أبدا. تظل جميع الاستفسارات الواردة محفوظة بشكل آمن في صندوق الوارد الخاص بلوحة التحكم، ويمكنك ترقيتها أو مراجعتها في أي وقت.

هل أنت مستعد لتبسيط الواجهة الخلفية للنموذج الخاص بك؟

انشر نقطة النهاية الأولى في أقل من دقيقتين. الطبقة المجانية متضمنة.

ابدأ مجانًا →