Passer au contenu
View in Postman (opens in new tab)

Remplacer des éléments du catalogue

put

/catalogs/{catalog_name}/items

Utilisez cet endpoint pour remplacer plusieurs éléments de votre catalogue.

Si un élément n’existe pas encore dans votre catalogue, cet endpoint le crée. Chaque requête peut contenir jusqu’à 50 éléments de catalogue. Cet endpoint est asynchrone.

Résolution des problèmes

Le tableau suivant répertorie les erreurs susceptibles d’être renvoyées, ainsi que les étapes de résolution des problèmes associées.

Erreur Résolution des problèmes
catalog-not-found Vérifiez que le nom du catalogue est valide.
company-size-limit-already-reached La limite de stockage du catalogue est atteinte. Pour en savoir plus sur les niveaux de stockage, consultez Limites de stockage des données.
company-size-limit-surge La requête dépasse l’espace de stockage de catalogue restant pour votre entreprise. Réessayez avec une mise à jour plus petite. Pour en savoir plus sur les niveaux de stockage, consultez Limites de stockage des données.
ids-not-strings Vérifiez que chaque ID d’élément est une chaîne de caractères.
ids-not-unique Vérifiez que chaque ID d’élément est unique.
ids-too-large Chaque ID d’élément est limité à 250 caractères.
items-array-is-invalid items doit être un tableau d’objets.
items-missing-ids Certains éléments n’ont pas d’ID. Vérifiez que chaque élément possède un ID.
items-too-large Les valeurs des éléments ne peuvent pas dépasser 5 000 caractères.
invalid-ids Les caractères pris en charge pour les noms d’ID d’élément sont les lettres, les chiffres, les traits d’union et les traits de soulignement.
invalid-fields Vérifiez que tous les champs que vous envoyez dans la requête API existent déjà dans le catalogue. Cette erreur n’est pas liée au champ ID mentionné dans le message d’erreur.
invalid-keys-in-value-object Les clés des objets d’élément ne peuvent pas contenir . ni $.
too-deep-nesting-in-value-object Les objets d’élément ne peuvent pas comporter plus de 50 niveaux d’imbrication.
request-includes-too-many-items Votre requête contient trop d’éléments. La limite est de 50 éléments par requête.
unable-to-coerce-value Les types d’éléments ne peuvent pas être convertis.

Vous pouvez télécharger le document OpenAPI et l’utiliser pour valider des schémas. Pour savoir comment procéder, consultez Utiliser les schémas OpenAPI pour la validation des requêtes.

New Stuff!