Skip to content

Supprimer plusieurs produits du catalogue

delete

/catalogs/{catalog_name}/items

Utilisez cet endpoint pour supprimer plusieurs produits de votre catalogue.

Chaque requête peut prendre en charge jusqu’à 50 produits. Cet endpoint est asynchrone.

Conditions préalables

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation catalogs.delete_items.

Limite de débit

Cet endpoint a une limite de débit partagée de 16 000 requêtes par minute entre tous les endpoints d’éléments de catalogue asynchrones, comme documenté dans Limites de débit de l’API.

Paramètres de chemin

Paramètre Requis Type de données Description
catalog_name Requis Chaîne de caractères Nom du catalogue.

Paramètres de requête

Paramètre Requis Type de données Description
items Requis Tableau Un tableau contenant des objets produit. Les objets produit doivent contenir un id faisant référence aux produits que Braze doit supprimer. Jusqu’à 50 objets sont autorisés par requête.

Exemple de requête

1
2
3
4
5
6
7
8
9
10
curl --location --request DELETE 'https://rest.iad-03.braze.com/catalogs/restaurants/items' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "items": [
    {"id": "restaurant1"},
    {"id": "restaurant2"},
    {"id": "restaurant3"}
  ]
}'

Réponse

Trois codes de statut sont possibles pour cet endpoint : 202, 400 et 404.

Exemple de réponse réussie

Le code de statut 202 pourrait renvoyer le corps de réponse suivant.

1
2
3
{
  "message": "success"
}

Exemple de réponse échouée

Le code de statut 400 pourrait renvoyer le corps de réponse suivant. Consultez la résolution des problèmes pour plus d’informations concernant les erreurs que vous pourriez rencontrer.

1
2
3
4
5
6
7
8
9
10
11
{
  "errors": [
    {
      "id": "items-missing-ids",
      "message": "There are 1 item(s) that do not have ids",
      "parameters": [],
      "parameter_values": []
    }
  ],
  "message": "Invalid Request"
}

Résolution des problèmes

Le tableau suivant répertorie les erreurs renvoyées possibles et 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.
ids-too-large Les ID de produit ne peuvent pas contenir plus de 250 caractères.
ids-not-unique Vérifiez que les ID de produit dans la requête sont uniques.
ids-not-strings Les ID de produit doivent être de type chaîne de caractères.
items-missing-ids Certains produits n’ont pas d’ID. Vérifiez que chaque produit possède un ID de produit.
invalid-ids Les ID de produit peuvent uniquement inclure des lettres, des chiffres, des traits d’union et des traits de soulignement.
request-includes-too-many-items Votre requête contient trop de produits. La limite de produits par requête est de 50.
New Stuff!