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

Remplacer un élément du catalogue

put

/catalogs/{catalog_name}/items/{item_id}

Utilisez cet endpoint pour remplacer un élément dans votre catalogue.

Si l’item_id est introuvable, cet endpoint crée l’élément dans votre catalogue. Cet endpoint est synchrone.

Résolution des problèmes

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

Erreur Résolution des problèmes
arbitrary-error Une erreur arbitraire s’est produite. Réessayez ou contactez l’assistance.
catalog-not-found Vérifiez que le nom du catalogue est valide.
filtered-set-field-too-long La valeur du champ est utilisée dans un ensemble filtré qui dépasse la limite de caractères d’un élément.
id-in-body Supprimez tous les ID d’élément du corps de la requête.
ids-too-large Chaque ID d’élément est limité à 250 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. Cela n’a aucun rapport avec le champ ID mentionné dans l’erreur.
invalid-keys-in-value-object Les clés d’objet d’élément ne peuvent pas inclure . ou $.
item-already-exists L’élément existe déjà dans le catalogue.
items-array-is-invalid items doit être un tableau d’objets.
items-too-large Chaque élément est limité à 5 000 caractères.
request-includes-too-many-items Vous ne pouvez créer qu’un seul élément de catalogue par requête.
too-deep-nesting-in-value-object Les objets d’élément ne peuvent pas comporter plus de 50 niveaux d’imbrication.
unable-to-coerce-value Les types d’élément 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 valider les requêtes.

New Stuff!