الانتقال إلى المحتوى الرئيسي
استخدم نقطة النهاية هذه لإرسال الإجابات إلى نموذج Plato.
POST /api/public/forms/[slug]
تتوقع نقطة النهاية هذه حاليًا وجود مفتاح API في سلسلة الاستعلام.

مثال

curl "https://api.plato.ae/api/public/forms/contact-us?apiKey=$PLATO_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Customer",
    "email": "[email protected]",
    "message": "I would like to learn more."
  }'

جسم

أرسل كائن JSON حيث يتطابق كل مفتاح مع حقل النموذج ref.
{
  "email": "[email protected]",
  "message": "I would like to learn more."
}

إجابة

{
  "message": "Submited form successfully."
}

ماذا يحدث بعد الإرسال

Plato:
  1. يبحث عن النموذج بواسطة سبيكة في مساحة العمل الرئيسية API.
  2. يخزن الاستجابة
  3. إنشاء إعلام بمساحة العمل.
  4. يرسل إشعارات البريد الإلكتروني الخاصة باستجابة النموذج.

لم يتم العثور عليه

إذا تم تعطيل النموذج أو أن الارتداد لا ينتمي إلى مساحة العمل، فسترجع Plato:
{
  "message": "Form not found."
}
مع الحالة 404.

حماية

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