supprimer plusieurs produits du catalogue
/catalogs/{catalog_name}/items
Utilisez cet endpoint pour supprimer plusieurs produits de votre catalogue.
Chaque requête peut prendre en charge jusqu’à 50 objets. 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
This endpoint has a shared rate limit of 16,000 requests per minute between all asynchronous catalog item endpoints, as documented in API rate limits.
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 demande
Paramètre | Requis | Type de données | Description |
---|---|---|---|
items |
Requis | Tableau | Un tableau qui contient certains 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 demande
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 réponses de code de statut existent 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 |
Il y a des produits qui n’ont pas d’ID de produit. Vérifiez que chaque produit possède un ID de produit. |
invalid-ids |
Ces 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 produit par requête est de 50. |