الانتقال إلى المحتوى الرئيسي
إنشاء إدخالات من التعليمات البرمجية من جانب الخادم فقط.
POST /api/public/cms/[modelId]/list

مثال

curl "https://api.plato.ae/api/public/cms/products/list?fields=id,name,price" \
  -X POST \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "values": {
      "name": {
        "en": "Classic Burger",
        "ar": "Classic Burger"
      },
      "price": 38,
      "published": true
    }
  }'

جسم

إرسال قيم الحقول داخل values:
{
  "values": {
    "title": {
      "en": "Summer Menu"
    },
    "published": true
  }
}
يقبل API أيضًا data أو كائن مباشر للتوافق، ولكن values هو التنسيق الأوضح.

إجابة

الرد هو الإدخال الذي تم إنشاؤه.
{
    "id": "entry_123",
    "name": {
      "en": "Classic Burger",
      "ar": "Classic Burger"
    },
  "price": 38
}
تم بنجاح إنشاء حالة الإرجاع 201.

الافتراضيات والحقول المطلوبة

عندما يكون للحقل قيمة افتراضية، يمكن لـ Plato تطبيقها أثناء الإنشاء. إذا كان الحقل المطلوب مفقودًا أو فارغًا، تقوم Plato بإرجاع:
{
  "message": "Field 'name' is required."
}

حدد الرد

استخدم fields عندما تحتاج فقط إلى جزء من الإدخال الذي تم إنشاؤه:
?fields=id,name
وهذا يبقي الاستجابة متوقعة وسريعة.