Aller au contenu principal

Créer un élément personnalisé

POST/custom/item/new/:customObjectId

Crée un élément personnalisé pour l'objet personnalisé spécifié, ou met à jour un élément existant (upsert).

Si l'objet personnalisé possède des champs définis comme identifiants uniques (isUniqueIdentifier), un élément est identifié par la combinaison des valeurs de tous ces champs. Lorsqu'un élément avec les mêmes valeurs existe déjà, il est mis à jour et son id est renvoyé. La réponse est 200 dans les deux cas.

  • La correspondance est exacte (sensible à la casse) : abc et ABC sont deux éléments différents.
  • Lors d'une mise à jour, name est remplacé et les champs non envoyés conservent leur valeur.
  • Envoyez une valeur pour chaque champ identifiant unique.
  • Sans champ identifiant unique, chaque appel crée un nouvel élément.

Un name vide ou une valeur manquante pour un champ identifiant unique renvoie 400 et rien n'est enregistré. Les valeurs envoyées pour des champs non publiés qui ne sont pas des identifiants uniques sont ignorées (non enregistrées). Les champs identifiants uniques non publiés restent enregistrés et utilisés pour identifier l'élément lors d'un upsert ; leurs valeurs restent obligatoires.

Request​

Responses​

Élément créé