> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plato.ae/llms.txt
> Use this file to discover all available pages before exploring further.

# إرسال استجابة النموذج

> أرسل ردًا على نموذج Plato من صفحة خارجية أو واجهة خلفية موثوقة.

استخدم نقطة النهاية هذه لإرسال الإجابات إلى نموذج Plato.

```text theme={null}
POST /api/public/forms/[slug]
```

تتوقع نقطة النهاية هذه حاليًا وجود مفتاح API في سلسلة الاستعلام.

## مثال

```bash theme={null}
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": "jane@example.com",
    "message": "I would like to learn more."
  }'
```

## جسم

أرسل كائن JSON حيث يتطابق كل مفتاح مع حقل النموذج `ref`.

```json theme={null}
{
  "email": "jane@example.com",
  "message": "I would like to learn more."
}
```

## إجابة

```json theme={null}
{
  "message": "Submited form successfully."
}
```

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

Plato:

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

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

إذا تم تعطيل النموذج أو أن الارتداد لا ينتمي إلى مساحة العمل، فسترجع Plato:

```json theme={null}
{
  "message": "Form not found."
}
```

مع الحالة `404`.

## حماية

قم بإرسال ردود النموذج من الواجهة الخلفية عندما يكون ذلك ممكنًا.

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