الانتقال إلى المحتوى الرئيسي
تأتي مفاتيح الحقول CMS من مخطط قاعدة البيانات في Plato CMS. استخدم مفتاح الحقل، وليس تسمية العرض، في طلبات API.

حقول النص

نص غير مترجم:
{
  "values": {
    "sku": "BURGER-CLASSIC"
  }
}
النص المترجم:
{
  "values": {
    "name": {
      "en": "Classic Burger",
      "ar": "Classic Burger"
    }
  }
}
إذا قمت بإرسال سلسلة عادية إلى حقل مترجم، فسيقوم Plato بتخزينها باللغة الإنجليزية.

أرقام

تقبل حقول الرقم وشريط التمرير والتقييم القيم الرقمية:
{
  "values": {
    "price": 38,
    "rating": 4.5
  }
}

القيم المنطقية

تبديل الحقول وحقول مربع الاختيار بدون خيارات تقبل القيم المنطقية:
{
  "values": {
    "published": true
  }
}

حدد وحدد متعدد

عادةً ما تقبل حقول التحديد المفردة قيمة خيار واحدة:
{
  "values": {
    "status": "published"
  }
}
تقبل حقول الأنماط متعددة التحديد مصفوفة:
{
  "values": {
    "tags": ["featured", "summer"]
  }
}
استخدم قيم الخيارات الثابتة من مخطط CMS.

التواريخ والأوقات

تتم تسوية حقول التاريخ والوقت مع سلاسل ISO.
{
  "values": {
    "startsAt": "2026-06-17T10:00:00.000Z"
  }
}

JSON

تقبل حقول JSON الكائنات أو المصفوفات أو الأرقام أو السلاسل أو القيم المنطقية أو null.
{
  "values": {
    "metadata": {
      "source": "website",
      "featured": true
    }
  }
}
إذا قمت بإرسال JSON كسلسلة، فيجب أن تكون صالحة JSON.

حقول الملفات والصور

تقوم حقول الملفات والصورة بتخزين مراجع الملفات. بالنسبة للحقول ذات الملف الفردي، أرسل قيمة واحدة:
{
  "values": {
    "heroImage": "file_id_or_url"
  }
}
بالنسبة للحقول متعددة الملفات، أرسل مصفوفة:
{
  "values": {
    "gallery": ["file_1", "file_2"]
  }
}

القيم الفارغة

استخدم null أو سلسلة فارغة لمسح معظم الحقول ذات القيمة الفردية. تصبح الحقول متعددة القيم مصفوفة فارغة عند مسحها. تصبح الحقول المنطقية false عند مسحها.