Passer au contenu principal
Les clés de champ CMS proviennent du schéma de base de données dans Plato CMS. Utilisez la clé de champ, et non l’étiquette d’affichage, dans les requêtes API.

​
Champs de texte

Texte non localisé : 
{
  "values": {
    "sku": "BURGER-CLASSIC"
  }
}
Texte localisé : 
{
  "values": {
    "name": {
      "en": "Classic Burger",
      "ar": "Classic Burger"
    }
  }
}
Si vous envoyez une chaîne simple à un champ localisé, Plato la stocke en anglais.

​
Nombres

Les champs de nombre, de curseur et de note acceptent des valeurs numériques : 
{
  "values": {
    "price": 38,
    "rating": 4.5
  }
}

​
Booléennes

Les champs à bascule et les champs à case à cocher sans options acceptent les booléens : 
{
  "values": {
    "published": true
  }
}

​
Sélection et sélection multiple

Les champs à sélection unique acceptent généralement une valeur d’option : 
{
  "values": {
    "status": "published"
  }
}
Les champs de style à sélection multiple acceptent un tableau : 
{
  "values": {
    "tags": ["featured", "summer"]
  }
}
Utilisez les valeurs d’option stables du schéma CMS.

​
Dates et heures

Les champs date et date-heure sont normalisés en chaînes ISO. 
{
  "values": {
    "startsAt": "2026-06-17T10:00:00.000Z"
  }
}

​
JSON

Les champs JSON acceptent des objets, des tableaux, des nombres, des chaînes, des booléens ou null. 
{
  "values": {
    "metadata": {
      "source": "website",
      "featured": true
    }
  }
}
Si vous envoyez JSON sous forme de chaîne, elle doit être valide JSON.

​
Champs de fichiers et d’images

Les champs de fichier et d’image stockent les références de fichiers. Pour les champs à fichier unique, envoyez une valeur : 
{
  "values": {
    "heroImage": "file_id_or_url"
  }
}
Pour les champs multi-fichiers, envoyez un tableau : 
{
  "values": {
    "gallery": ["file_1", "file_2"]
  }
}

​
Valeurs vides

Utilisez null ou une chaîne vide pour effacer la plupart des champs à valeur unique. Les champs à valeurs multiples deviennent un tableau vide lorsqu’ils sont effacés. Les champs booléens deviennent false lorsqu’ils sont effacés.